quapp 1.0.0

package/README.md

@@ -0,0 +1,29 @@
+# Quapp CLI 🧪
+
+**Quapp CLI** is a developer-friendly CLI tool to serve and Build quapps in a quick and Easy manner
+
+---
+
+## 🚀 Features
+
+- ⚡ Create Quapp's Quickly and Efficently
+- 📱 Serve locally and share via LAN QR code  
+- 📁 Lightweight and extensible project setup  
+
+---
+
+## 📦 Installation
+
+```bash
+npm install quapp
+
+```
+## 🔧 Usage
+
+```bash
+    quapp serve
+
+    quapp build
+
+    quapp
+```

package/bin/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+import { spawn } from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+
+// Resolve __dirname in ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Get user command
+const args = process.argv.slice(2);
+const command = args[0];
+
+// Path to files inside your package
+const buildPath = path.join(__dirname, "../build.js");
+const servePath = path.join(__dirname, "../server.js");
+
+// Helper to run a file with Node
+function runScript(scriptPath) {
+  const child = spawn("node", [scriptPath], { stdio: "inherit" });
+  child.on("close", (code) => process.exit(code));
+}
+
+switch (command) {
+  case "build":
+    runScript(buildPath);
+    break;
+  case "serve":
+    runScript(servePath);
+    break;
+  default:
+    console.log(`
+\x1b[1m\x1b[34mQuapp CLI\x1b[0m
+
+Usage:
+  quapp build       Run production build and compress to dist.quapp
+  quapp serve       Start local server for testing your app
+
+Options:
+  -h, --help        Show this help message
+
+Examples:
+  quapp build
+  quapp serve
+`);
+    break;
+}

package/build.js

@@ -0,0 +1,87 @@
+import { execSync } from "child_process";
+import fs from "fs";
+import { rm } from "fs/promises";
+import path from "path";
+import archiver from "archiver";
+import { fileURLToPath } from "url";
+
+// ASCII color codes for console
+const c = {
+  blue: "\x1b[34m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+};
+
+// __dirname workaround for ESM
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Paths
+const projectRoot = process.cwd();
+const distFolder = path.join(projectRoot, "dist");
+const outputQpp = path.join(projectRoot, "dist.qpp");
+
+console.log(`${c.blue}\n📦 Starting production build...${c.reset}`);
+
+try {
+  // Step 1: Run build
+  try {
+    execSync("npm run build", { stdio: "inherit" });
+  } catch (err) {
+    console.error(`${c.red}❌ Build process failed. Please check your build script.${c.reset}`);
+    process.exit(1);
+  }
+
+  // Step 2: Verify dist/ exists
+  if (!fs.existsSync(distFolder)) {
+    console.error(`${c.red}❌ Build folder 'dist/' not found!${c.reset}`);
+    process.exit(1);
+  }
+
+  // Step 3: Compress dist/ into dist.qpp using archiver
+  await new Promise((resolve, reject) => {
+    const output = fs.createWriteStream(outputQpp);
+    const archive = archiver("zip", { zlib: { level: 9 } });
+
+    output.on("close", () => {
+      console.log(`${c.green}\n✅ Project built and compressed → ${c.bold}dist.qpp${c.reset}`);
+      resolve();
+    });
+
+    output.on("error", (err) => {
+      console.error(`${c.red}❌ Failed to write output file: ${err.message}${c.reset}`);
+      reject(err);
+    });
+
+    archive.on("warning", (err) => {
+      if (err.code === "ENOENT") {
+        console.warn(`${c.yellow}⚠️ Archive warning: ${err.message}${c.reset}`);
+      } else {
+        reject(err);
+      }
+    });
+
+    archive.on("error", (err) => {
+      console.error(`${c.red}❌ Archiving failed: ${err.message}${c.reset}`);
+      reject(err);
+    });
+
+    archive.pipe(output);
+    archive.directory(distFolder, false);
+    archive.finalize();
+  });
+
+  // Step 4: Remove dist folder
+  try {
+    await rm(distFolder, { recursive: true, force: true });
+  } catch (err) {
+    console.warn(`${c.yellow}⚠️ Could not remove dist/: ${err.message}${c.reset}`);
+  }
+
+} catch (err) {
+  console.error(`${c.red}\n❌ Unexpected failure: ${err.message}${c.reset}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "quapp",
+  "version": "1.0.0",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "type": "module",
+  "author": "",
+  "bin": {
+    "quapp": "./bin/cli.js"
+  },
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "open": "^10.1.2",
+    "qrcode-terminal": "^0.12.0"
+  }
+}

package/server.js

@@ -0,0 +1,128 @@
+import { spawn } from "child_process";
+import os from "os";
+import qrcode from "qrcode-terminal";
+import fs from "fs";
+import path from "path";
+import open from "open";
+
+// Load config
+let config = {
+  server: {
+    qr: true,
+    network: "private",
+    port: 5173,
+    fallbackPort: true,
+    https: false,
+    openBrowser: false,
+    autoRetry: true,
+    strictPort: false
+  }
+};
+
+try {
+  const configPath = path.resolve("quapp.config.json");
+  if (fs.existsSync(configPath)) {
+    const userConfig = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    config = {
+      ...config,
+      ...userConfig,
+      server: { ...config.server, ...userConfig.server }
+    };
+  }
+} catch (err) {
+  console.warn("⚠️ Failed to read quapp.config.json. Using default config.");
+}
+
+// Get local or LAN IP
+function getIP(networkType = "local") {
+  if (networkType === "private") {
+    const interfaces = os.networkInterfaces();
+    for (const key in interfaces) {
+      for (const iface of interfaces[key] || []) {
+        if (!iface.internal && iface.family === "IPv4") {
+          return iface.address;
+        }
+      }
+    }
+  }
+  return "localhost";
+}
+
+// Start Vite with fallback logic
+function startVite(port, attempt = 0) {
+  const host = config.server.network === "private" ? getIP("private") : "localhost";
+  const url = `${config.server.https ? "https" : "http"}://${host}:${port}`;
+
+  const viteArgs = [
+    "--host",
+    host,
+    "--port",
+    port,
+    // 🛠 Automatically enable strictPort if autoRetry is false
+    ...(config.server.strictPort || !config.server.autoRetry ? ["--strictPort"] : []),
+    ...(config.server.https ? ["--https"] : [])
+  ];
+
+  const viteProcess = spawn("vite", viteArgs, { shell: true });
+
+  let shown = false;
+
+  viteProcess.stdout.on("data", (data) => {
+    const output = data.toString();
+
+    const portMatch = output.match(/http[s]?:\/\/.*:(\d+)/);
+    if (portMatch && !shown) {
+      const usedPort = parseInt(portMatch[1]);
+      const finalUrl = `${config.server.https ? "https" : "http"}://${host}:${usedPort}`;
+
+      console.log(`\n\n🌍 Access your app from LAN at: ${finalUrl}`);
+      if (config.server.qr) {
+        console.log(`\n📱 Scan the QR code below to open on any device:\n`);
+        qrcode.generate(finalUrl, { small: true });
+      }
+
+      if (config.server.openBrowser) {
+        open(finalUrl); // ✅ Uses external open package
+      }
+
+      shown = true;
+    }
+
+    process.stdout.write(data);
+  });
+
+  viteProcess.stderr.on("data", (data) => {
+    process.stderr.write(data);
+  });
+
+  viteProcess.on("exit", (code) => {
+    if (
+      code !== 0 &&
+      config.server.fallbackPort &&
+      config.server.autoRetry &&
+      attempt < 10
+    ) {
+      console.log(`⚠️ Port ${port} might be in use. Retrying on port ${port + 1}...`);
+      startVite(port + 1, attempt + 1);
+    } else {
+      console.log(`❌ Vite exited with code ${code}`);
+    }
+  });
+}
+// Check if Vite is installed
+function checkViteInstalled() {
+  try {
+    require.resolve("vite");
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+// Check if Vite is installed
+if (checkViteInstalled()) {
+  console.error("❌ Vite is not installed. Please install it globally or in your project.");
+  process.exit(1);
+}
+
+// Kickoff
+startVite(config.server.port);