@universal-pwa/cli 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 UniversalPWA
+
+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,110 @@
+# @universal-pwa/cli
+
+Interface en ligne de commande pour UniversalPWA.
+
+## Installation
+
+```bash
+npm install -g @universal-pwa/cli
+```
+
+## Utilisation
+
+### Commande `init`
+
+Initialise une PWA dans votre projet.
+
+```bash
+universal-pwa init [options]
+```
+
+**Options :**
+
+- `-p, --project-path <path>` : Chemin du projet (défaut: répertoire courant)
+- `-n, --name <name>` : Nom de l'application
+- `-s, --short-name <shortName>` : Nom court (max 12 caractères)
+- `-i, --icon-source <path>` : Image source pour les icônes
+- `-t, --theme-color <color>` : Couleur du thème (hex, ex: `#2c3e50`)
+- `-b, --background-color <color>` : Couleur de fond (hex)
+- `--skip-icons` : Ignorer la génération d'icônes
+- `--skip-service-worker` : Ignorer la génération du service worker
+- `--skip-injection` : Ignorer l'injection des meta-tags
+- `-o, --output-dir <dir>` : Répertoire de sortie (défaut: `public`)
+
+**Exemple :**
+
+```bash
+universal-pwa init \
+  --name "Mon Application" \
+  --short-name "MonApp" \
+  --icon-source ./logo.png \
+  --theme-color "#2c3e50"
+```
+
+### Commande `scan`
+
+Scanne un projet et détecte le framework, l'architecture et les assets.
+
+```bash
+universal-pwa scan [options]
+```
+
+**Options :**
+
+- `-p, --project-path <path>` : Chemin du projet (défaut: répertoire courant)
+
+**Exemple :**
+
+```bash
+universal-pwa scan
+```
+
+### Commande `preview`
+
+Prévisualise la configuration PWA d'un projet.
+
+```bash
+universal-pwa preview [options]
+```
+
+**Options :**
+
+- `-p, --project-path <path>` : Chemin du projet (défaut: répertoire courant)
+- `--port <port>` : Port du serveur (défaut: `3000`)
+- `--open` : Ouvrir dans le navigateur
+
+**Exemple :**
+
+```bash
+universal-pwa preview --port 8080
+```
+
+## API Programmatique
+
+Vous pouvez également utiliser le CLI comme module :
+
+```typescript
+import { initCommand } from '@universal-pwa/cli'
+
+const result = await initCommand({
+  projectPath: './my-project',
+  name: 'My App',
+  iconSource: './icon.png',
+})
+```
+
+## Développement
+
+```bash
+# Installer les dépendances
+pnpm install
+
+# Build
+pnpm build
+
+# Tests
+pnpm test
+
+# Lint
+pnpm lint
+```

package/dist/index.cjs

@@ -0,0 +1,334 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+var import_chalk3 = __toESM(require("chalk"), 1);
+
+// src/commands/init.ts
+var import_core = require("@universal-pwa/core");
+var import_core2 = require("@universal-pwa/core");
+var import_core3 = require("@universal-pwa/core");
+var import_core4 = require("@universal-pwa/core");
+var import_core5 = require("@universal-pwa/core");
+var import_core6 = require("@universal-pwa/core");
+var import_chalk = __toESM(require("chalk"), 1);
+var import_fs = require("fs");
+var import_glob = require("glob");
+var import_path = require("path");
+async function initCommand(options = {}) {
+  const {
+    projectPath = process.cwd(),
+    name,
+    shortName,
+    iconSource,
+    themeColor,
+    backgroundColor,
+    skipIcons = false,
+    skipServiceWorker = false,
+    skipInjection = false,
+    outputDir
+  } = options;
+  const result = {
+    success: false,
+    projectPath: (0, import_path.resolve)(projectPath),
+    framework: null,
+    architecture: "static",
+    iconsGenerated: 0,
+    htmlFilesInjected: 0,
+    warnings: [],
+    errors: []
+  };
+  try {
+    if (!(0, import_fs.existsSync)(result.projectPath)) {
+      result.errors.push(`Project path does not exist: ${result.projectPath}`);
+      return result;
+    }
+    console.log(import_chalk.default.blue("\u{1F50D} Scanning project..."));
+    const scanResult = await (0, import_core.scanProject)({
+      projectPath: result.projectPath,
+      includeAssets: true,
+      includeArchitecture: true
+    });
+    result.framework = scanResult.framework.framework;
+    result.architecture = scanResult.architecture.architecture;
+    console.log(import_chalk.default.green(`\u2713 Framework detected: ${result.framework ?? "Unknown"}`));
+    console.log(import_chalk.default.green(`\u2713 Architecture: ${result.architecture}`));
+    const httpsCheck = (0, import_core6.checkProjectHttps)({ projectPath: result.projectPath });
+    if (!httpsCheck.isSecure && !httpsCheck.isLocalhost) {
+      result.warnings.push(httpsCheck.warning ?? "HTTPS required for production PWA");
+      console.log(import_chalk.default.yellow(`\u26A0 ${httpsCheck.warning}`));
+    }
+    const finalOutputDir = outputDir ?? (result.framework === "WordPress" ? (0, import_path.join)(result.projectPath, "public") : (0, import_path.join)(result.projectPath, "public"));
+    console.log(import_chalk.default.blue("\u{1F4DD} Generating manifest.json..."));
+    const appName = name ?? (result.framework ? `${result.framework} App` : "My PWA");
+    const appShortName = shortName ?? appName.substring(0, 12);
+    let iconPaths = [];
+    if (!skipIcons && iconSource) {
+      const iconSourcePath = (0, import_fs.existsSync)(iconSource) ? iconSource : (0, import_path.join)(result.projectPath, iconSource);
+      if ((0, import_fs.existsSync)(iconSourcePath)) {
+        console.log(import_chalk.default.blue("\u{1F3A8} Generating icons..."));
+        try {
+          const iconResult = await (0, import_core3.generateIcons)({
+            sourceImage: iconSourcePath,
+            outputDir: finalOutputDir
+          });
+          iconPaths = iconResult.icons.map((icon) => icon.src);
+          result.iconsGenerated = iconResult.icons.length;
+          console.log(import_chalk.default.green(`\u2713 Generated ${result.iconsGenerated} icons`));
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          result.errors.push(`Failed to generate icons: ${errorMessage}`);
+          console.log(import_chalk.default.red(`\u2717 Failed to generate icons: ${errorMessage}`));
+        }
+      } else {
+        result.warnings.push(`Icon source not found: ${iconSourcePath}`);
+      }
+    }
+    if (iconPaths.length > 0) {
+      const manifestWithIcons = (0, import_core2.generateManifest)({
+        name: appName,
+        shortName: appShortName,
+        startUrl: "/",
+        scope: "/",
+        display: "standalone",
+        themeColor: themeColor ?? "#ffffff",
+        backgroundColor: backgroundColor ?? "#000000",
+        icons: iconPaths.map((src) => ({
+          src,
+          sizes: src.match(/(\d+)x(\d+)/)?.[0] ?? "192x192",
+          type: "image/png"
+        }))
+      });
+      const manifestPath = (0, import_core2.generateAndWriteManifest)(manifestWithIcons, finalOutputDir);
+      result.manifestPath = manifestPath;
+    } else {
+      result.warnings.push("No icons provided. Manifest requires at least one icon. Please provide an icon source with --icon-source");
+      console.log(import_chalk.default.yellow("\u26A0 Manifest not generated: icons are required"));
+    }
+    if (!skipServiceWorker) {
+      console.log(import_chalk.default.blue("\u2699\uFE0F Generating service worker..."));
+      try {
+        const swResult = await (0, import_core4.generateServiceWorker)({
+          projectPath: result.projectPath,
+          outputDir: finalOutputDir,
+          architecture: result.architecture,
+          framework: result.framework,
+          globDirectory: finalOutputDir,
+          globPatterns: ["**/*.{html,js,css,png,jpg,jpeg,svg,webp,woff,woff2}"]
+        });
+        result.serviceWorkerPath = swResult.swPath;
+        console.log(import_chalk.default.green(`\u2713 Service worker generated: ${result.serviceWorkerPath}`));
+        console.log(import_chalk.default.gray(`  Pre-cached ${swResult.count} files`));
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Failed to generate service worker: ${errorMessage}`);
+        console.log(import_chalk.default.red(`\u2717 Failed to generate service worker: ${errorMessage}`));
+      }
+    }
+    if (!skipInjection) {
+      console.log(import_chalk.default.blue("\u{1F489} Injecting meta-tags..."));
+      try {
+        const htmlFiles = await (0, import_glob.glob)("**/*.html", {
+          cwd: result.projectPath,
+          ignore: ["**/node_modules/**", "**/dist/**", "**/.next/**", "**/.nuxt/**"],
+          absolute: true
+        });
+        let injectedCount = 0;
+        for (const htmlFile of htmlFiles.slice(0, 10)) {
+          try {
+            const injectionResult = (0, import_core5.injectMetaTagsInFile)(htmlFile, {
+              manifestPath: result.manifestPath ? (0, import_path.join)("/", result.manifestPath.replace(result.projectPath, "")) : "/manifest.json",
+              themeColor: themeColor ?? "#ffffff",
+              backgroundColor: backgroundColor ?? "#000000",
+              appleTouchIcon: iconPaths.find((p) => p.includes("180")) ?? "/apple-touch-icon.png",
+              appleMobileWebAppCapable: true,
+              serviceWorkerPath: result.serviceWorkerPath ? (0, import_path.join)("/", result.serviceWorkerPath.replace(result.projectPath, "")) : "/sw.js"
+            });
+            if (injectionResult.injected.length > 0) {
+              injectedCount++;
+            }
+          } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            result.warnings.push(`Failed to inject meta-tags in ${htmlFile}: ${errorMessage}`);
+          }
+        }
+        result.htmlFilesInjected = injectedCount;
+        console.log(import_chalk.default.green(`\u2713 Injected meta-tags in ${injectedCount} HTML file(s)`));
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Failed to inject meta-tags: ${errorMessage}`);
+        console.log(import_chalk.default.red(`\u2717 Failed to inject meta-tags: ${errorMessage}`));
+      }
+    }
+    result.success = result.errors.length === 0;
+    if (result.success) {
+      console.log(import_chalk.default.green("\n\u2705 PWA setup completed successfully!"));
+    } else {
+      console.log(import_chalk.default.red(`
+\u274C PWA setup completed with ${result.errors.length} error(s)`));
+    }
+    return result;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    result.errors.push(`Unexpected error: ${errorMessage}`);
+    console.log(import_chalk.default.red(`\u2717 Unexpected error: ${errorMessage}`));
+    return result;
+  }
+}
+
+// src/commands/preview.ts
+var import_chalk2 = __toESM(require("chalk"), 1);
+var import_fs2 = require("fs");
+var import_path2 = require("path");
+var import_core7 = require("@universal-pwa/core");
+function previewCommand(options = {}) {
+  const {
+    projectPath = process.cwd(),
+    port = 3e3
+  } = options;
+  const result = {
+    success: false,
+    port,
+    url: `http://localhost:${port}`,
+    manifestExists: false,
+    serviceWorkerExists: false,
+    warnings: [],
+    errors: []
+  };
+  try {
+    const resolvedPath = (0, import_path2.resolve)(projectPath);
+    if (!(0, import_fs2.existsSync)(resolvedPath)) {
+      result.errors.push(`Project path does not exist: ${resolvedPath}`);
+      return result;
+    }
+    console.log(import_chalk2.default.blue("\u{1F50D} Checking PWA setup..."));
+    const manifestPath = (0, import_path2.join)(resolvedPath, "public", "manifest.json");
+    const manifestPathAlt = (0, import_path2.join)(resolvedPath, "manifest.json");
+    if ((0, import_fs2.existsSync)(manifestPath) || (0, import_fs2.existsSync)(manifestPathAlt)) {
+      result.manifestExists = true;
+      console.log(import_chalk2.default.green("\u2713 manifest.json found"));
+    } else {
+      result.warnings.push("manifest.json not found");
+      console.log(import_chalk2.default.yellow("\u26A0 manifest.json not found"));
+    }
+    const swPath = (0, import_path2.join)(resolvedPath, "public", "sw.js");
+    const swPathAlt = (0, import_path2.join)(resolvedPath, "sw.js");
+    if ((0, import_fs2.existsSync)(swPath) || (0, import_fs2.existsSync)(swPathAlt)) {
+      result.serviceWorkerExists = true;
+      console.log(import_chalk2.default.green("\u2713 Service worker found"));
+    } else {
+      result.warnings.push("Service worker (sw.js) not found");
+      console.log(import_chalk2.default.yellow("\u26A0 Service worker (sw.js) not found"));
+    }
+    try {
+      const httpsCheck = (0, import_core7.checkProjectHttps)({ projectPath: resolvedPath });
+      if (!httpsCheck.isSecure && !httpsCheck.isLocalhost && httpsCheck.warning) {
+        result.warnings.push(httpsCheck.warning);
+        console.log(import_chalk2.default.yellow(`\u26A0 ${httpsCheck.warning}`));
+      }
+    } catch {
+    }
+    console.log(import_chalk2.default.blue(`
+\u{1F4E6} PWA Preview would be available at: ${result.url}`));
+    console.log(import_chalk2.default.gray("   (Server not started in preview mode - use a static server like `serve` or `http-server`)"));
+    result.success = result.errors.length === 0;
+    if (result.success) {
+      console.log(import_chalk2.default.green("\n\u2705 PWA preview check completed"));
+    } else {
+      console.log(import_chalk2.default.red(`
+\u274C PWA preview check failed with ${result.errors.length} error(s)`));
+    }
+    return result;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    result.errors.push(`Unexpected error: ${errorMessage}`);
+    console.log(import_chalk2.default.red(`\u2717 Unexpected error: ${errorMessage}`));
+    return result;
+  }
+}
+
+// src/index.ts
+var import_core8 = require("@universal-pwa/core");
+var program = new import_commander.Command();
+program.name("universal-pwa").description("Transform any web project into a PWA with one click").version("0.0.0");
+program.command("init").description("Initialize PWA in your project").option("-p, --project-path <path>", "Project path", process.cwd()).option("-n, --name <name>", "App name").option("-s, --short-name <shortName>", "App short name (max 12 chars)").option("-i, --icon-source <path>", "Source image for icons").option("-t, --theme-color <color>", "Theme color (hex)").option("-b, --background-color <color>", "Background color (hex)").option("--skip-icons", "Skip icon generation").option("--skip-service-worker", "Skip service worker generation").option("--skip-injection", "Skip HTML meta-tag injection").option("-o, --output-dir <dir>", "Output directory", "public").action(async (options) => {
+  try {
+    const result = await initCommand({
+      projectPath: options.projectPath,
+      name: options.name,
+      shortName: options.shortName,
+      iconSource: options.iconSource,
+      themeColor: options.themeColor,
+      backgroundColor: options.backgroundColor,
+      skipIcons: options.skipIcons,
+      skipServiceWorker: options.skipServiceWorker,
+      skipInjection: options.skipInjection,
+      outputDir: options.outputDir
+    });
+    process.exit(result.success ? 0 : 1);
+  } catch (error) {
+    console.error(import_chalk3.default.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program.command("preview").description("Preview PWA setup").option("-p, --project-path <path>", "Project path", process.cwd()).option("--port <port>", "Server port", "3000").option("--open", "Open in browser", false).action(async (options) => {
+  try {
+    const result = await previewCommand({
+      projectPath: options.projectPath,
+      port: options.port ? Number.parseInt(options.port, 10) : void 0,
+      open: options.open
+    });
+    process.exit(result.success ? 0 : 1);
+  } catch (error) {
+    console.error(import_chalk3.default.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program.command("scan").description("Scan project and detect framework/architecture").option("-p, --project-path <path>", "Project path", process.cwd()).action(async (options) => {
+  try {
+    console.log(import_chalk3.default.blue("\u{1F50D} Scanning project..."));
+    const result = await (0, import_core8.scanProject)({
+      projectPath: options.projectPath ?? process.cwd(),
+      includeAssets: true,
+      includeArchitecture: true
+    });
+    console.log(import_chalk3.default.green(`
+\u2713 Framework: ${result.framework.framework ?? "Unknown"}`));
+    console.log(import_chalk3.default.green(`\u2713 Architecture: ${result.architecture.architecture}`));
+    console.log(import_chalk3.default.green(`\u2713 Build Tool: ${result.architecture.buildTool ?? "Unknown"}`));
+    console.log(import_chalk3.default.gray(`
+Assets found:`));
+    console.log(import_chalk3.default.gray(`  - JavaScript: ${result.assets.javascript.length} files`));
+    console.log(import_chalk3.default.gray(`  - CSS: ${result.assets.css.length} files`));
+    console.log(import_chalk3.default.gray(`  - Images: ${result.assets.images.length} files`));
+    console.log(import_chalk3.default.gray(`  - Fonts: ${result.assets.fonts.length} files`));
+    process.exit(0);
+  } catch (error) {
+    console.error(import_chalk3.default.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program.parse();

package/dist/index.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk3 from "chalk";
+
+// src/commands/init.ts
+import { scanProject } from "@universal-pwa/core";
+import { generateManifest, generateAndWriteManifest } from "@universal-pwa/core";
+import { generateIcons } from "@universal-pwa/core";
+import { generateServiceWorker } from "@universal-pwa/core";
+import { injectMetaTagsInFile } from "@universal-pwa/core";
+import { checkProjectHttps } from "@universal-pwa/core";
+import chalk from "chalk";
+import { existsSync } from "fs";
+import { glob } from "glob";
+import { join, resolve } from "path";
+async function initCommand(options = {}) {
+  const {
+    projectPath = process.cwd(),
+    name,
+    shortName,
+    iconSource,
+    themeColor,
+    backgroundColor,
+    skipIcons = false,
+    skipServiceWorker = false,
+    skipInjection = false,
+    outputDir
+  } = options;
+  const result = {
+    success: false,
+    projectPath: resolve(projectPath),
+    framework: null,
+    architecture: "static",
+    iconsGenerated: 0,
+    htmlFilesInjected: 0,
+    warnings: [],
+    errors: []
+  };
+  try {
+    if (!existsSync(result.projectPath)) {
+      result.errors.push(`Project path does not exist: ${result.projectPath}`);
+      return result;
+    }
+    console.log(chalk.blue("\u{1F50D} Scanning project..."));
+    const scanResult = await scanProject({
+      projectPath: result.projectPath,
+      includeAssets: true,
+      includeArchitecture: true
+    });
+    result.framework = scanResult.framework.framework;
+    result.architecture = scanResult.architecture.architecture;
+    console.log(chalk.green(`\u2713 Framework detected: ${result.framework ?? "Unknown"}`));
+    console.log(chalk.green(`\u2713 Architecture: ${result.architecture}`));
+    const httpsCheck = checkProjectHttps({ projectPath: result.projectPath });
+    if (!httpsCheck.isSecure && !httpsCheck.isLocalhost) {
+      result.warnings.push(httpsCheck.warning ?? "HTTPS required for production PWA");
+      console.log(chalk.yellow(`\u26A0 ${httpsCheck.warning}`));
+    }
+    const finalOutputDir = outputDir ?? (result.framework === "WordPress" ? join(result.projectPath, "public") : join(result.projectPath, "public"));
+    console.log(chalk.blue("\u{1F4DD} Generating manifest.json..."));
+    const appName = name ?? (result.framework ? `${result.framework} App` : "My PWA");
+    const appShortName = shortName ?? appName.substring(0, 12);
+    let iconPaths = [];
+    if (!skipIcons && iconSource) {
+      const iconSourcePath = existsSync(iconSource) ? iconSource : join(result.projectPath, iconSource);
+      if (existsSync(iconSourcePath)) {
+        console.log(chalk.blue("\u{1F3A8} Generating icons..."));
+        try {
+          const iconResult = await generateIcons({
+            sourceImage: iconSourcePath,
+            outputDir: finalOutputDir
+          });
+          iconPaths = iconResult.icons.map((icon) => icon.src);
+          result.iconsGenerated = iconResult.icons.length;
+          console.log(chalk.green(`\u2713 Generated ${result.iconsGenerated} icons`));
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          result.errors.push(`Failed to generate icons: ${errorMessage}`);
+          console.log(chalk.red(`\u2717 Failed to generate icons: ${errorMessage}`));
+        }
+      } else {
+        result.warnings.push(`Icon source not found: ${iconSourcePath}`);
+      }
+    }
+    if (iconPaths.length > 0) {
+      const manifestWithIcons = generateManifest({
+        name: appName,
+        shortName: appShortName,
+        startUrl: "/",
+        scope: "/",
+        display: "standalone",
+        themeColor: themeColor ?? "#ffffff",
+        backgroundColor: backgroundColor ?? "#000000",
+        icons: iconPaths.map((src) => ({
+          src,
+          sizes: src.match(/(\d+)x(\d+)/)?.[0] ?? "192x192",
+          type: "image/png"
+        }))
+      });
+      const manifestPath = generateAndWriteManifest(manifestWithIcons, finalOutputDir);
+      result.manifestPath = manifestPath;
+    } else {
+      result.warnings.push("No icons provided. Manifest requires at least one icon. Please provide an icon source with --icon-source");
+      console.log(chalk.yellow("\u26A0 Manifest not generated: icons are required"));
+    }
+    if (!skipServiceWorker) {
+      console.log(chalk.blue("\u2699\uFE0F Generating service worker..."));
+      try {
+        const swResult = await generateServiceWorker({
+          projectPath: result.projectPath,
+          outputDir: finalOutputDir,
+          architecture: result.architecture,
+          framework: result.framework,
+          globDirectory: finalOutputDir,
+          globPatterns: ["**/*.{html,js,css,png,jpg,jpeg,svg,webp,woff,woff2}"]
+        });
+        result.serviceWorkerPath = swResult.swPath;
+        console.log(chalk.green(`\u2713 Service worker generated: ${result.serviceWorkerPath}`));
+        console.log(chalk.gray(`  Pre-cached ${swResult.count} files`));
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Failed to generate service worker: ${errorMessage}`);
+        console.log(chalk.red(`\u2717 Failed to generate service worker: ${errorMessage}`));
+      }
+    }
+    if (!skipInjection) {
+      console.log(chalk.blue("\u{1F489} Injecting meta-tags..."));
+      try {
+        const htmlFiles = await glob("**/*.html", {
+          cwd: result.projectPath,
+          ignore: ["**/node_modules/**", "**/dist/**", "**/.next/**", "**/.nuxt/**"],
+          absolute: true
+        });
+        let injectedCount = 0;
+        for (const htmlFile of htmlFiles.slice(0, 10)) {
+          try {
+            const injectionResult = injectMetaTagsInFile(htmlFile, {
+              manifestPath: result.manifestPath ? join("/", result.manifestPath.replace(result.projectPath, "")) : "/manifest.json",
+              themeColor: themeColor ?? "#ffffff",
+              backgroundColor: backgroundColor ?? "#000000",
+              appleTouchIcon: iconPaths.find((p) => p.includes("180")) ?? "/apple-touch-icon.png",
+              appleMobileWebAppCapable: true,
+              serviceWorkerPath: result.serviceWorkerPath ? join("/", result.serviceWorkerPath.replace(result.projectPath, "")) : "/sw.js"
+            });
+            if (injectionResult.injected.length > 0) {
+              injectedCount++;
+            }
+          } catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            result.warnings.push(`Failed to inject meta-tags in ${htmlFile}: ${errorMessage}`);
+          }
+        }
+        result.htmlFilesInjected = injectedCount;
+        console.log(chalk.green(`\u2713 Injected meta-tags in ${injectedCount} HTML file(s)`));
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Failed to inject meta-tags: ${errorMessage}`);
+        console.log(chalk.red(`\u2717 Failed to inject meta-tags: ${errorMessage}`));
+      }
+    }
+    result.success = result.errors.length === 0;
+    if (result.success) {
+      console.log(chalk.green("\n\u2705 PWA setup completed successfully!"));
+    } else {
+      console.log(chalk.red(`
+\u274C PWA setup completed with ${result.errors.length} error(s)`));
+    }
+    return result;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    result.errors.push(`Unexpected error: ${errorMessage}`);
+    console.log(chalk.red(`\u2717 Unexpected error: ${errorMessage}`));
+    return result;
+  }
+}
+
+// src/commands/preview.ts
+import chalk2 from "chalk";
+import { existsSync as existsSync2 } from "fs";
+import { join as join2, resolve as resolve2 } from "path";
+import { checkProjectHttps as checkProjectHttps2 } from "@universal-pwa/core";
+function previewCommand(options = {}) {
+  const {
+    projectPath = process.cwd(),
+    port = 3e3
+  } = options;
+  const result = {
+    success: false,
+    port,
+    url: `http://localhost:${port}`,
+    manifestExists: false,
+    serviceWorkerExists: false,
+    warnings: [],
+    errors: []
+  };
+  try {
+    const resolvedPath = resolve2(projectPath);
+    if (!existsSync2(resolvedPath)) {
+      result.errors.push(`Project path does not exist: ${resolvedPath}`);
+      return result;
+    }
+    console.log(chalk2.blue("\u{1F50D} Checking PWA setup..."));
+    const manifestPath = join2(resolvedPath, "public", "manifest.json");
+    const manifestPathAlt = join2(resolvedPath, "manifest.json");
+    if (existsSync2(manifestPath) || existsSync2(manifestPathAlt)) {
+      result.manifestExists = true;
+      console.log(chalk2.green("\u2713 manifest.json found"));
+    } else {
+      result.warnings.push("manifest.json not found");
+      console.log(chalk2.yellow("\u26A0 manifest.json not found"));
+    }
+    const swPath = join2(resolvedPath, "public", "sw.js");
+    const swPathAlt = join2(resolvedPath, "sw.js");
+    if (existsSync2(swPath) || existsSync2(swPathAlt)) {
+      result.serviceWorkerExists = true;
+      console.log(chalk2.green("\u2713 Service worker found"));
+    } else {
+      result.warnings.push("Service worker (sw.js) not found");
+      console.log(chalk2.yellow("\u26A0 Service worker (sw.js) not found"));
+    }
+    try {
+      const httpsCheck = checkProjectHttps2({ projectPath: resolvedPath });
+      if (!httpsCheck.isSecure && !httpsCheck.isLocalhost && httpsCheck.warning) {
+        result.warnings.push(httpsCheck.warning);
+        console.log(chalk2.yellow(`\u26A0 ${httpsCheck.warning}`));
+      }
+    } catch {
+    }
+    console.log(chalk2.blue(`
+\u{1F4E6} PWA Preview would be available at: ${result.url}`));
+    console.log(chalk2.gray("   (Server not started in preview mode - use a static server like `serve` or `http-server`)"));
+    result.success = result.errors.length === 0;
+    if (result.success) {
+      console.log(chalk2.green("\n\u2705 PWA preview check completed"));
+    } else {
+      console.log(chalk2.red(`
+\u274C PWA preview check failed with ${result.errors.length} error(s)`));
+    }
+    return result;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    result.errors.push(`Unexpected error: ${errorMessage}`);
+    console.log(chalk2.red(`\u2717 Unexpected error: ${errorMessage}`));
+    return result;
+  }
+}
+
+// src/index.ts
+import { scanProject as scanProject2 } from "@universal-pwa/core";
+var program = new Command();
+program.name("universal-pwa").description("Transform any web project into a PWA with one click").version("0.0.0");
+program.command("init").description("Initialize PWA in your project").option("-p, --project-path <path>", "Project path", process.cwd()).option("-n, --name <name>", "App name").option("-s, --short-name <shortName>", "App short name (max 12 chars)").option("-i, --icon-source <path>", "Source image for icons").option("-t, --theme-color <color>", "Theme color (hex)").option("-b, --background-color <color>", "Background color (hex)").option("--skip-icons", "Skip icon generation").option("--skip-service-worker", "Skip service worker generation").option("--skip-injection", "Skip HTML meta-tag injection").option("-o, --output-dir <dir>", "Output directory", "public").action(async (options) => {
+  try {
+    const result = await initCommand({
+      projectPath: options.projectPath,
+      name: options.name,
+      shortName: options.shortName,
+      iconSource: options.iconSource,
+      themeColor: options.themeColor,
+      backgroundColor: options.backgroundColor,
+      skipIcons: options.skipIcons,
+      skipServiceWorker: options.skipServiceWorker,
+      skipInjection: options.skipInjection,
+      outputDir: options.outputDir
+    });
+    process.exit(result.success ? 0 : 1);
+  } catch (error) {
+    console.error(chalk3.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program.command("preview").description("Preview PWA setup").option("-p, --project-path <path>", "Project path", process.cwd()).option("--port <port>", "Server port", "3000").option("--open", "Open in browser", false).action(async (options) => {
+  try {
+    const result = await previewCommand({
+      projectPath: options.projectPath,
+      port: options.port ? Number.parseInt(options.port, 10) : void 0,
+      open: options.open
+    });
+    process.exit(result.success ? 0 : 1);
+  } catch (error) {
+    console.error(chalk3.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program.command("scan").description("Scan project and detect framework/architecture").option("-p, --project-path <path>", "Project path", process.cwd()).action(async (options) => {
+  try {
+    console.log(chalk3.blue("\u{1F50D} Scanning project..."));
+    const result = await scanProject2({
+      projectPath: options.projectPath ?? process.cwd(),
+      includeAssets: true,
+      includeArchitecture: true
+    });
+    console.log(chalk3.green(`
+\u2713 Framework: ${result.framework.framework ?? "Unknown"}`));
+    console.log(chalk3.green(`\u2713 Architecture: ${result.architecture.architecture}`));
+    console.log(chalk3.green(`\u2713 Build Tool: ${result.architecture.buildTool ?? "Unknown"}`));
+    console.log(chalk3.gray(`
+Assets found:`));
+    console.log(chalk3.gray(`  - JavaScript: ${result.assets.javascript.length} files`));
+    console.log(chalk3.gray(`  - CSS: ${result.assets.css.length} files`));
+    console.log(chalk3.gray(`  - Images: ${result.assets.images.length} files`));
+    console.log(chalk3.gray(`  - Fonts: ${result.assets.fonts.length} files`));
+    process.exit(0);
+  } catch (error) {
+    console.error(chalk3.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@universal-pwa/cli",
+  "version": "0.1.0",
+  "description": "CLI pour transformer n'importe quel projet web en PWA",
+  "keywords": [
+    "pwa",
+    "progressive-web-app",
+    "cli",
+    "workbox",
+    "service-worker"
+  ],
+  "author": "julien-lin",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/julien-lin/UniversalPWA.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/julien-lin/UniversalPWA#readme",
+  "bugs": {
+    "url": "https://github.com/julien-lin/UniversalPWA/issues"
+  },
+  "type": "module",
+  "bin": {
+    "universal-pwa": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.3.3",
+    "glob": "^13.0.0",
+    "pino": "^9.14.0",
+    "zod": "^4.2.1",
+    "@universal-pwa/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.4",
+    "tsup": "^8.3.0",
+    "tsx": "^4.19.0",
+    "typescript": "~5.9.3",
+    "vitest": "^2.1.4"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup src/index.ts --dts --format esm,cjs",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest"
+  }
+}