@julien-lin/universal-pwa-cli 1.3.14 → 1.3.16

package/README.fr.md

@@ -17,19 +17,7 @@ Cette commande va :
 - Générer tous les assets PWA (icônes, manifest, service worker)
 - Injecter les meta tags dans vos fichiers HTML
 
-Aucune installation globale nécessaire !
-
-## Installation
-
-```bash
-npm install -g @julien-lin/universal-pwa-cli
-```
-
-Ou avec pnpm :
-
-```bash
-pnpm add -g @julien-lin/universal-pwa-cli
-```
+Aucune installation globale — npx est la méthode recommandée pour exécuter le CLI.
 
 ## Utilisation
 
@@ -50,7 +38,7 @@ pnpm build
 yarn build
 
 # 2. Puis initialiser la PWA (le CLI détectera automatiquement dist/)
-universal-pwa init --output-dir dist
+npx @julien-lin/universal-pwa-cli init --output-dir dist
 ```
 
 **Pourquoi ?** Le service worker doit precacher tous vos assets buildés (JS/CSS avec hash). Si vous initialisez avant de builder, le service worker ne connaîtra pas les noms de fichiers hashés.
@@ -62,7 +50,7 @@ Le CLI détecte automatiquement le répertoire `dist/` pour les projets React/Vi
 Exécutez simplement sans arguments pour lancer les prompts interactifs :
 
 ```bash
-universal-pwa init
+npx @julien-lin/universal-pwa-cli init
 ```
 
 Le CLI vous guidera à travers :
@@ -76,7 +64,7 @@ Le CLI vous guidera à travers :
 #### Mode Ligne de Commande
 
 ```bash
-universal-pwa init [options]
+npx @julien-lin/universal-pwa-cli init [options]
 ```
 
 **Options :**
@@ -98,23 +86,23 @@ universal-pwa init [options]
 ```bash
 # Pour un build de production (React/Vite)
 npm run build
-universal-pwa init --output-dir dist --icon-source ./logo.png
+npx @julien-lin/universal-pwa-cli init --output-dir dist --icon-source ./logo.png
 
 # Pour le développement ou sites statiques
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "Mon Application" \
   --short-name "MonApp" \
   --icon-source ./logo.png \
   --theme-color "#2c3e50"
 
 # Pour un déploiement sous un sous-chemin
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "CreativeHub" \
   --output-dir public \
   --base-path "/creativehub/"
 
 # Pour une PWA basée sur une API
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "PWA API" \
   --output-dir dist \
   --base-path "/api/pwa/"
@@ -151,7 +139,7 @@ Cela garantit:
 
 ```bash
 npm run build
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "Creative Hub" \
   --output-dir public \
   --base-path "/creative-hub/"
@@ -161,7 +149,7 @@ universal-pwa init \
 
 ```bash
 pnpm build
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --output-dir .next \
   --base-path "/dashboard/"
 ```
@@ -169,7 +157,7 @@ universal-pwa init \
 **Site Statique sur Hébergement Partagé** - Déployé à `example.com/apps/myapp/`:
 
 ```bash
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "Mon App" \
   --output-dir dist \
   --base-path "/apps/myapp/"
@@ -261,7 +249,7 @@ Le script injecté émet des événements personnalisés que vous pouvez écoute
 Scanne un projet et détecte le framework, l'architecture et les assets.
 
 ```bash
-universal-pwa scan [options]
+npx @julien-lin/universal-pwa-cli scan [options]
 ```
 
 **Options :**
@@ -271,7 +259,7 @@ universal-pwa scan [options]
 **Exemple :**
 
 ```bash
-universal-pwa scan
+npx @julien-lin/universal-pwa-cli scan
 ```
 
 Affiche :
@@ -286,7 +274,7 @@ Affiche :
 Prévisualise la configuration PWA d'un projet.
 
 ```bash
-universal-pwa preview [options]
+npx @julien-lin/universal-pwa-cli preview [options]
 ```
 
 **Options :**
@@ -298,12 +286,12 @@ universal-pwa preview [options]
 **Exemple :**
 
 ```bash
-universal-pwa preview --port 8080
+npx @julien-lin/universal-pwa-cli preview --port 8080
 ```
 
 ## Fichiers Générés
 
-Après avoir exécuté `universal-pwa init`, les fichiers suivants sont générés :
+Après avoir exécuté `npx @julien-lin/universal-pwa-cli init`, les fichiers suivants sont générés :
 
 - `manifest.json` - Fichier manifest PWA
 - `sw.js` - Service Worker (Workbox)

package/README.md

@@ -19,19 +19,7 @@ This command will:
 - Generate all PWA assets (icons, manifest, service worker)
 - Inject meta tags into your HTML files
 
-No global installation needed!
-
-## Installation
-
-```bash
-npm install -g @julien-lin/universal-pwa-cli
-```
-
-Or with pnpm:
-
-```bash
-pnpm add -g @julien-lin/universal-pwa-cli
-```
+No global installation needed — npx is the recommended way to run the CLI.
 
 ## Configuration
 
@@ -40,7 +28,7 @@ UniversalPWA peut être configuré via un fichier de configuration pour éviter
 ### Génération automatique
 
 ```bash
-universal-pwa generate-config
+npx @julien-lin/universal-pwa-cli generate-config
 ```
 
 Cette commande génère un fichier `universal-pwa.config.ts` (ou `.js`, `.json`, `.yaml`) basé sur votre projet.
@@ -83,10 +71,10 @@ yarn build
 # 2. Then initialize PWA
 # In interactive mode, select "Production" when prompted
 # The CLI will auto-detect dist/ directory and suggest it
-universal-pwa init
+npx @julien-lin/universal-pwa-cli init
 
 # Or explicitly specify output directory
-universal-pwa init --output-dir dist
+npx @julien-lin/universal-pwa-cli init --output-dir dist
 ```
 
 **Why?** The service worker needs to precache all your built assets (JS/CSS with hashes). If you initialize before building, the service worker won't know about the hashed filenames.
@@ -104,7 +92,7 @@ universal-pwa init --output-dir dist
 Simply run without arguments to launch interactive prompts:
 
 ```bash
-universal-pwa init
+npx @julien-lin/universal-pwa-cli init
 ```
 
 The CLI will guide you through a 2-phase workflow:
@@ -128,7 +116,7 @@ All prompts include smart defaults, validation, and contextual suggestions!
 #### Command Line Mode
 
 ```bash
-universal-pwa init [options]
+npx @julien-lin/universal-pwa-cli init [options]
 ```
 
 **Options:**
@@ -150,23 +138,23 @@ universal-pwa init [options]
 ```bash
 # For production build (React/Vite)
 npm run build
-universal-pwa init --output-dir dist --icon-source ./logo.png
+npx @julien-lin/universal-pwa-cli init --output-dir dist --icon-source ./logo.png
 
 # For development or static sites
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "My Application" \
   --short-name "MyApp" \
   --icon-source ./logo.png \
   --theme-color "#2c3e50"
 
 # For deployment under a subpath
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "CreativeHub" \
   --output-dir public \
   --base-path "/creativehub/"
 
 # For API-based PWA
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "PWA API" \
   --output-dir dist \
   --base-path "/api/pwa/"
@@ -203,7 +191,7 @@ This ensures:
 
 ```bash
 npm run build
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "Creative Hub" \
   --output-dir public \
   --base-path "/creative-hub/"
@@ -213,7 +201,7 @@ universal-pwa init \
 
 ```bash
 pnpm build
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --output-dir .next \
   --base-path "/dashboard/"
 ```
@@ -221,7 +209,7 @@ universal-pwa init \
 **Static Site on Shared Hosting** - Deployed at `example.com/apps/myapp/`:
 
 ```bash
-universal-pwa init \
+npx @julien-lin/universal-pwa-cli init \
   --name "My App" \
   --output-dir dist \
   --base-path "/apps/myapp/"
@@ -313,7 +301,7 @@ The injected script emits custom events you can listen to:
 Scan a project and detect framework, architecture, and assets.
 
 ```bash
-universal-pwa scan [options]
+npx @julien-lin/universal-pwa-cli scan [options]
 ```
 
 **Options:**
@@ -323,7 +311,7 @@ universal-pwa scan [options]
 **Example:**
 
 ```bash
-universal-pwa scan
+npx @julien-lin/universal-pwa-cli scan
 ```
 
 Output:
@@ -338,7 +326,7 @@ Output:
 Preview the PWA configuration of a project.
 
 ```bash
-universal-pwa preview [options]
+npx @julien-lin/universal-pwa-cli preview [options]
 ```
 
 **Options:**
@@ -350,12 +338,12 @@ universal-pwa preview [options]
 **Example:**
 
 ```bash
-universal-pwa preview --port 8080
+npx @julien-lin/universal-pwa-cli preview --port 8080
 ```
 
 ## Generated Files
 
-After running `universal-pwa init`, the following files are generated:
+After running `npx @julien-lin/universal-pwa-cli init`, the following files are generated:
 
 - `manifest.json` - PWA manifest file
 - `sw.js` - Service Worker (Workbox)

package/dist/index.cjs

@@ -375,9 +375,9 @@ async function loadProjectConfig(projectPath) {
       strict: false
       // Don't throw on validation errors, just warn
     });
-    const config = result?.config ?? null;
-    const filePath = result?.filePath ?? null;
-    const format = result?.format ?? null;
+    const config = result.config ?? null;
+    const filePath = result.filePath ?? null;
+    const format = result.format ?? null;
     return {
       config,
       filePath,
@@ -429,9 +429,14 @@ function mergeConfigWithOptions(config, cliOptions) {
     merged.skipServiceWorker = generate !== void 0 ? !generate : false;
   }
   const injectionConfig = cfg?.injection;
-  if (injectionConfig && merged.skipInjection === void 0) {
-    const inject = injectionConfig.inject;
-    merged.skipInjection = inject !== void 0 ? !inject : false;
+  if (injectionConfig) {
+    if (merged.skipInjection === void 0) {
+      const inject = injectionConfig.inject;
+      merged.skipInjection = inject !== void 0 ? !inject : false;
+    }
+    if (!merged.htmlExtensions && Array.isArray(injectionConfig.extensions)) {
+      merged.htmlExtensions = injectionConfig.extensions;
+    }
   }
   const outputConfig = cfg?.output;
   if (outputConfig && !merged.outputDir) {
@@ -457,6 +462,9 @@ async function getEffectiveConfig(projectPath, cliOptions) {
   };
 }
 
+// src/commands/init.ts
+var import_universal_pwa_core9 = require("@julien-lin/universal-pwa-core");
+
 // src/utils/ui-utils.ts
 var import_chalk2 = __toESM(require("chalk"), 1);
 var import_strip_ansi = __toESM(require("strip-ansi"), 1);
@@ -780,7 +788,8 @@ async function initCommand(options = {}) {
     skipInjection = false,
     outputDir,
     basePath: rawBasePath,
-    maxHtmlFiles
+    maxHtmlFiles,
+    htmlExtensions
   } = mergedOptions;
   const result = {
     success: false,
@@ -794,10 +803,18 @@ async function initCommand(options = {}) {
   };
   let finalBasePath;
   try {
-    const effectiveBasePath = rawBasePath || "/";
+    let effectiveBasePath;
+    if (rawBasePath) {
+      effectiveBasePath = rawBasePath;
+    } else {
+      const detected = (0, import_universal_pwa_core9.detectBasePath)(result.projectPath);
+      effectiveBasePath = detected.basePath != null && detected.confidence >= 0.7 ? detected.basePath : "/";
+    }
     finalBasePath = normalizeBasePath(effectiveBasePath);
-    if (effectiveBasePath && effectiveBasePath !== "/") {
-      console.log(import_chalk3.default.gray(`  Base path: ${finalBasePath}`));
+    if (finalBasePath !== "/") {
+      console.log(
+        import_chalk3.default.gray(`  Base path: ${finalBasePath}${rawBasePath ? "" : " (auto)"}`)
+      );
     }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
@@ -845,6 +862,7 @@ async function initCommand(options = {}) {
     } else {
       const distDir = (0, import_path2.join)(result.projectPath, "dist");
       const publicDir = (0, import_path2.join)(result.projectPath, "public");
+      const staticDir = (0, import_path2.join)(result.projectPath, "static");
       if ((result.framework === "react" || result.framework === "nextjs") && (0, import_fs2.existsSync)(distDir)) {
         finalOutputDir = distDir;
         console.log(
@@ -852,6 +870,13 @@ async function initCommand(options = {}) {
         );
       } else if (result.framework === "wordpress") {
         finalOutputDir = publicDir;
+      } else if ((result.framework === "django" || result.framework === "flask") && (0, import_fs2.existsSync)(staticDir)) {
+        finalOutputDir = staticDir;
+        console.log(
+          import_chalk3.default.gray(
+            `  Using static/ directory (${result.framework} detected)`
+          )
+        );
       } else if ((0, import_fs2.existsSync)(publicDir)) {
         finalOutputDir = publicDir;
       } else if ((0, import_fs2.existsSync)(distDir)) {
@@ -883,6 +908,27 @@ async function initCommand(options = {}) {
         transaction.backupFile(swRelative);
       }
     }
+    const factory = (0, import_universal_pwa_core8.getBackendFactory)();
+    let backendIntegration = null;
+    if (factory && typeof factory === "object" && "detectBackend" in factory) {
+      backendIntegration = factory.detectBackend(result.projectPath) ?? null;
+    }
+    if (!backendIntegration && result.framework && factory && typeof factory === "object" && "getIntegration" in factory) {
+      backendIntegration = factory.getIntegration(
+        result.framework,
+        result.projectPath
+      );
+      if (backendIntegration && typeof backendIntegration === "object" && "detect" in backendIntegration) {
+        const detectionResult = backendIntegration.detect();
+        if (detectionResult && typeof detectionResult === "object") {
+          const detected = detectionResult.detected ?? false;
+          const confidence = detectionResult.confidence ?? "low";
+          if (!detected || confidence === "low") {
+            backendIntegration = null;
+          }
+        }
+      }
+    }
     console.log(import_chalk3.default.blue("\u{1F4DD} Generating manifest.json..."));
     const appName = name ?? (result.framework ? `${result.framework} App` : "My PWA");
     const normalizedShortName = shortName && typeof shortName === "string" && shortName.trim().length > 0 ? shortName.trim() : void 0;
@@ -974,18 +1020,22 @@ async function initCommand(options = {}) {
     } catch {
       manifestId = appName.toLowerCase().replace(/[^a-z0-9-]/g, "-").substring(0, 20);
     }
+    const backendManifestDefaults = backendIntegration && typeof backendIntegration === "object" && "generateManifestVariables" in backendIntegration && typeof backendIntegration.generateManifestVariables === "function" ? (0, import_universal_pwa_core3.mapBackendManifestVarsToOptions)(
+      backendIntegration.generateManifestVariables()
+    ) : {};
     let manifestPath;
     try {
       if (iconPaths.length > 0) {
         const manifestWithIconsOptions = {
+          ...backendManifestDefaults,
           name: appName,
           shortName: finalShortName,
           id: manifestId,
           startUrl: finalBasePath,
           scope: finalBasePath,
           display: "standalone",
-          themeColor: themeColor ?? "#ffffff",
-          backgroundColor: backgroundColor ?? "#000000",
+          themeColor: themeColor ?? backendManifestDefaults.themeColor ?? "#ffffff",
+          backgroundColor: backgroundColor ?? backendManifestDefaults.backgroundColor ?? "#000000",
           icons: iconPaths.map((src) => ({
             src,
             sizes: src.match(/(\d+)x(\d+)/)?.[0] ?? "192x192",
@@ -1016,14 +1066,15 @@ async function initCommand(options = {}) {
           import_chalk3.default.yellow("\u26A0 Generating manifest with placeholder icon")
         );
         const manifestMinimalOptions = {
+          ...backendManifestDefaults,
           name: appName,
           shortName: finalShortName,
           id: manifestId,
           startUrl: finalBasePath,
           scope: finalBasePath,
           display: "standalone",
-          themeColor: themeColor ?? "#ffffff",
-          backgroundColor: backgroundColor ?? "#000000",
+          themeColor: themeColor ?? backendManifestDefaults.themeColor ?? "#ffffff",
+          backgroundColor: backgroundColor ?? backendManifestDefaults.backgroundColor ?? "#000000",
           icons: [
             {
               src: "/icon-192x192.png",
@@ -1064,24 +1115,6 @@ async function initCommand(options = {}) {
     if (!skipServiceWorker) {
       console.log(import_chalk3.default.blue("\u2699\uFE0F Generating service worker..."));
       try {
-        const factory = (0, import_universal_pwa_core8.getBackendFactory)();
-        let backendIntegration = null;
-        if (factory && typeof factory === "object" && "detectBackend" in factory) {
-          backendIntegration = factory.detectBackend(result.projectPath);
-        }
-        if (!backendIntegration && result.framework && factory && typeof factory === "object" && "getIntegration" in factory) {
-          backendIntegration = factory.getIntegration(result.framework, result.projectPath);
-          if (backendIntegration && typeof backendIntegration === "object" && "detect" in backendIntegration) {
-            const detectionResult = backendIntegration.detect();
-            if (detectionResult && typeof detectionResult === "object") {
-              const detected = detectionResult.detected ?? false;
-              const confidence = detectionResult.confidence ?? "low";
-              if (!detected || confidence === "low") {
-                backendIntegration = null;
-              }
-            }
-          }
-        }
         let swResult;
         if (backendIntegration && typeof backendIntegration === "object" && "detect" in backendIntegration && "name" in backendIntegration) {
           const detectionResult = backendIntegration.detect();
@@ -1196,16 +1229,33 @@ async function initCommand(options = {}) {
     if (!skipInjection) {
       console.log(import_chalk3.default.blue("\u{1F489} Injecting meta-tags..."));
       try {
-        const htmlFiles = await (0, import_glob.glob)("**/*.{html,twig,html.twig,blade.php}", {
-          cwd: result.projectPath,
-          ignore: [
-            "**/node_modules/**",
-            "**/.next/**",
-            "**/.nuxt/**",
-            "**/vendor/**"
-          ],
-          absolute: true
-        });
+        const useWordPressRestricted = result.framework === "wordpress" && !(htmlExtensions && htmlExtensions.length > 0);
+        let htmlFiles;
+        if (useWordPressRestricted) {
+          htmlFiles = await (0, import_glob.glob)([...import_universal_pwa_core9.WORDPRESS_INJECTION_PATTERNS], {
+            cwd: result.projectPath,
+            ignore: [
+              "**/node_modules/**",
+              "**/.next/**",
+              "**/.nuxt/**",
+              "**/vendor/**"
+            ],
+            absolute: true
+          });
+        } else {
+          const injectionExts = htmlExtensions && htmlExtensions.length > 0 ? htmlExtensions : [...import_universal_pwa_core9.DEFAULT_INJECTION_EXTENSIONS];
+          const htmlGlobPattern = injectionExts.length > 0 ? `**/*.{${injectionExts.join(",")}}` : "**/*.html";
+          htmlFiles = await (0, import_glob.glob)(htmlGlobPattern, {
+            cwd: result.projectPath,
+            ignore: [
+              "**/node_modules/**",
+              "**/.next/**",
+              "**/.nuxt/**",
+              "**/vendor/**"
+            ],
+            absolute: true
+          });
+        }
         htmlFiles.sort((a, b) => {
           const aInDist = a.includes("/dist/");
           const bInDist = b.includes("/dist/");
@@ -1228,10 +1278,15 @@ async function initCommand(options = {}) {
           const bladeCount = htmlFiles.filter(
             (f) => f.endsWith(".blade.php")
           ).length;
+          const wpThemeCount = useWordPressRestricted ? htmlFiles.filter(
+            (f) => f.endsWith("header.php") || f.endsWith("footer.php")
+          ).length : 0;
           const fileTypes = [];
           if (htmlCount > 0) fileTypes.push(`${htmlCount} HTML`);
           if (twigCount > 0) fileTypes.push(`${twigCount} Twig`);
           if (bladeCount > 0) fileTypes.push(`${bladeCount} Blade`);
+          if (wpThemeCount > 0)
+            fileTypes.push(`${wpThemeCount} WordPress theme`);
           const typeSummary = fileTypes.length > 0 ? ` (${fileTypes.join(", ")})` : "";
           console.log(
             import_chalk3.default.gray(
@@ -1482,7 +1537,7 @@ async function initCommand(options = {}) {
 var import_chalk4 = __toESM(require("chalk"), 1);
 var import_fs3 = require("fs");
 var import_path3 = require("path");
-var import_universal_pwa_core9 = require("@julien-lin/universal-pwa-core");
+var import_universal_pwa_core10 = require("@julien-lin/universal-pwa-core");
 async function previewCommand(options = {}) {
   const {
     projectPath = process.cwd(),
@@ -1523,7 +1578,7 @@ async function previewCommand(options = {}) {
       console.log(import_chalk4.default.yellow("\u26A0 Service worker (sw.js) not found"));
     }
     try {
-      const httpsCheck = (0, import_universal_pwa_core9.checkProjectHttps)({ projectPath: resolvedPath });
+      const httpsCheck = (0, import_universal_pwa_core10.checkProjectHttps)({ projectPath: resolvedPath });
       if (!httpsCheck.isSecure && !httpsCheck.isLocalhost && httpsCheck.warning) {
         result.warnings.push(httpsCheck.warning);
         console.log(import_chalk4.default.yellow(`\u26A0 ${httpsCheck.warning}`));
@@ -1554,7 +1609,7 @@ var import_fs4 = require("fs");
 var import_path4 = require("path");
 var import_glob2 = require("glob");
 var import_chalk5 = __toESM(require("chalk"), 1);
-var import_universal_pwa_core10 = require("@julien-lin/universal-pwa-core");
+var import_universal_pwa_core11 = require("@julien-lin/universal-pwa-core");
 async function verifyCommand(options = {}) {
   const {
     projectPath = process.cwd(),
@@ -1587,7 +1642,7 @@ async function verifyCommand(options = {}) {
       absolute: true
     });
     console.log(import_chalk5.default.blue("\u{1F50D} Running comprehensive PWA validation..."));
-    const validationResult = await (0, import_universal_pwa_core10.validatePWA)({
+    const validationResult = await (0, import_universal_pwa_core11.validatePWA)({
       projectPath: result.projectPath,
       outputDir: finalOutputDir,
       htmlFiles,
@@ -1753,7 +1808,7 @@ async function verifyCommand(options = {}) {
 }
 
 // src/commands/remove.ts
-var import_universal_pwa_core11 = require("@julien-lin/universal-pwa-core");
+var import_universal_pwa_core12 = require("@julien-lin/universal-pwa-core");
 var import_chalk6 = __toESM(require("chalk"), 1);
 var import_fs6 = require("fs");
 var import_glob4 = require("glob");
@@ -1777,7 +1832,7 @@ function isPWAScript(content) {
   return lowerContent.includes("serviceworker") || lowerContent.includes("navigator.serviceworker") || lowerContent.includes("register") && lowerContent.includes("sw") || lowerContent.includes("sw.js") || lowerContent.includes("beforeinstallprompt") || lowerContent.includes("window.installpwa") || lowerContent.includes("ispwainstalled") || lowerContent.includes("ispwainstallable") || lowerContent.includes("deferredprompt");
 }
 async function removeMetaTags(htmlContent) {
-  const parsed = (0, import_universal_pwa_core11.parseHTML)(htmlContent);
+  const parsed = (0, import_universal_pwa_core12.parseHTML)(htmlContent);
   const removed = [];
   if (!parsed.head) {
     return { html: htmlContent, removed: [] };
@@ -1849,7 +1904,7 @@ async function removeCommand(options = {}) {
       return result;
     }
     console.log(import_chalk6.default.blue("\u{1F50D} Scanning project for PWA files..."));
-    const scanResult = await (0, import_universal_pwa_core11.scanProject)({
+    const scanResult = await (0, import_universal_pwa_core12.scanProject)({
       projectPath: result.projectPath,
       includeAssets: false,
       includeArchitecture: false
@@ -1983,7 +2038,7 @@ async function removeCommand(options = {}) {
 }
 
 // src/commands/generate-config.ts
-var import_universal_pwa_core12 = require("@julien-lin/universal-pwa-core");
+var import_universal_pwa_core13 = require("@julien-lin/universal-pwa-core");
 var import_node_fs = require("fs");
 var import_node_path2 = require("path");
 var import_chalk7 = __toESM(require("chalk"), 1);
@@ -2007,7 +2062,7 @@ async function generateConfigCommand(options = {}) {
       return result;
     }
     console.log(import_chalk7.default.blue("\u{1F50D} Scanning project..."));
-    const scanResult = await (0, import_universal_pwa_core12.scanProject)({
+    const scanResult = await (0, import_universal_pwa_core13.scanProject)({
       projectPath: resolvedPath,
       includeAssets: true,
       includeArchitecture: true
@@ -2036,7 +2091,9 @@ async function generateConfigCommand(options = {}) {
         }
       ]);
       if (!overwrite) {
-        result.errors.push("Configuration file already exists and overwrite was cancelled");
+        result.errors.push(
+          "Configuration file already exists and overwrite was cancelled"
+        );
         return result;
       }
     }
@@ -2294,7 +2351,7 @@ function formatYAMLConfig(config) {
 }
 
 // src/index.ts
-var import_universal_pwa_core13 = require("@julien-lin/universal-pwa-core");
+var import_universal_pwa_core14 = require("@julien-lin/universal-pwa-core");
 
 // src/prompts.ts
 var import_fs8 = require("fs");
@@ -2680,7 +2737,7 @@ async function promptInitOptions(projectPath, framework, architecture = null) {
 // package.json
 var package_default = {
   name: "@julien-lin/universal-pwa-cli",
-  version: "1.3.14",
+  version: "1.3.16",
   description: "CLI to transform any web project into a PWA",
   keywords: [
     "pwa",
@@ -2777,14 +2834,14 @@ var normalizeConfigFormat = (value) => {
   throw new Error(`Invalid format: ${value ?? "undefined"}`);
 };
 program.name("universal-pwa").description("Transform any web project into a PWA with one click").version(version);
-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").option("--force-scan", "Force scan (bypass cache)").option("--no-cache", "Disable cache").option("--max-html-files <number>", "Maximum number of HTML files to process (default: unlimited)", (value) => Number.parseInt(value, 10)).action(async (options) => {
+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").option("--force-scan", "Force scan (bypass cache)").option("--no-cache", "Disable cache").option("--max-html-files <number>", "Maximum number of HTML files to process (default: unlimited)", (value) => Number.parseInt(value, 10)).option("--html-extensions <extensions>", "Comma-separated HTML/template extensions (e.g. html,twig,blade.php,j2)", (value) => value ? value.split(",").map((s) => s.trim()).filter(Boolean) : void 0).action(async (options) => {
   try {
     const projectPath = options.projectPath ?? process.cwd();
     const hasOptions = options.name || options.shortName || options.iconSource || options.themeColor || options.backgroundColor || options.skipIcons !== void 0;
     let finalOptions = { ...options };
     if (!hasOptions) {
       console.log(import_chalk9.default.blue("\u{1F50D} Scanning project..."));
-      const scanResult = await (0, import_universal_pwa_core13.scanProject)({
+      const scanResult = await (0, import_universal_pwa_core14.scanProject)({
         projectPath,
         includeAssets: false,
         includeArchitecture: false
@@ -2836,7 +2893,8 @@ program.command("init").description("Initialize PWA in your project").option("-p
       outputDir: finalOptions.outputDir,
       forceScan: options.forceScan,
       noCache: options.noCache,
-      maxHtmlFiles: options.maxHtmlFiles
+      maxHtmlFiles: options.maxHtmlFiles,
+      htmlExtensions: options.htmlExtensions
     });
     process.exit(result.success ? 0 : 1);
   } catch (error) {
@@ -2860,7 +2918,7 @@ program.command("preview").description("Preview PWA setup").option("-p, --projec
 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_chalk9.default.blue("\u{1F50D} Scanning project..."));
-    const result = await (0, import_universal_pwa_core13.scanProject)({
+    const result = await (0, import_universal_pwa_core14.scanProject)({
       projectPath: options.projectPath ?? process.cwd(),
       includeAssets: true,
       includeArchitecture: true

package/dist/index.js

@@ -11,7 +11,8 @@ import chalk9 from "chalk";
 import { scanProject, optimizeProject } from "@julien-lin/universal-pwa-core";
 import {
   generateAndWriteManifest,
-  generateManifestId
+  generateManifestId,
+  mapBackendManifestVarsToOptions
 } from "@julien-lin/universal-pwa-core";
 import { generateIcons } from "@julien-lin/universal-pwa-core";
 import {
@@ -264,9 +265,9 @@ async function loadProjectConfig(projectPath) {
       strict: false
       // Don't throw on validation errors, just warn
     });
-    const config = result?.config ?? null;
-    const filePath = result?.filePath ?? null;
-    const format = result?.format ?? null;
+    const config = result.config ?? null;
+    const filePath = result.filePath ?? null;
+    const format = result.format ?? null;
     return {
       config,
       filePath,
@@ -318,9 +319,14 @@ function mergeConfigWithOptions(config, cliOptions) {
     merged.skipServiceWorker = generate !== void 0 ? !generate : false;
   }
   const injectionConfig = cfg?.injection;
-  if (injectionConfig && merged.skipInjection === void 0) {
-    const inject = injectionConfig.inject;
-    merged.skipInjection = inject !== void 0 ? !inject : false;
+  if (injectionConfig) {
+    if (merged.skipInjection === void 0) {
+      const inject = injectionConfig.inject;
+      merged.skipInjection = inject !== void 0 ? !inject : false;
+    }
+    if (!merged.htmlExtensions && Array.isArray(injectionConfig.extensions)) {
+      merged.htmlExtensions = injectionConfig.extensions;
+    }
   }
   const outputConfig = cfg?.output;
   if (outputConfig && !merged.outputDir) {
@@ -346,6 +352,13 @@ async function getEffectiveConfig(projectPath, cliOptions) {
   };
 }
 
+// src/commands/init.ts
+import {
+  DEFAULT_INJECTION_EXTENSIONS,
+  WORDPRESS_INJECTION_PATTERNS,
+  detectBasePath
+} from "@julien-lin/universal-pwa-core";
+
 // src/utils/ui-utils.ts
 import chalk2 from "chalk";
 import stripAnsi from "strip-ansi";
@@ -669,7 +682,8 @@ async function initCommand(options = {}) {
     skipInjection = false,
     outputDir,
     basePath: rawBasePath,
-    maxHtmlFiles
+    maxHtmlFiles,
+    htmlExtensions
   } = mergedOptions;
   const result = {
     success: false,
@@ -683,10 +697,18 @@ async function initCommand(options = {}) {
   };
   let finalBasePath;
   try {
-    const effectiveBasePath = rawBasePath || "/";
+    let effectiveBasePath;
+    if (rawBasePath) {
+      effectiveBasePath = rawBasePath;
+    } else {
+      const detected = detectBasePath(result.projectPath);
+      effectiveBasePath = detected.basePath != null && detected.confidence >= 0.7 ? detected.basePath : "/";
+    }
     finalBasePath = normalizeBasePath(effectiveBasePath);
-    if (effectiveBasePath && effectiveBasePath !== "/") {
-      console.log(chalk3.gray(`  Base path: ${finalBasePath}`));
+    if (finalBasePath !== "/") {
+      console.log(
+        chalk3.gray(`  Base path: ${finalBasePath}${rawBasePath ? "" : " (auto)"}`)
+      );
     }
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
@@ -734,6 +756,7 @@ async function initCommand(options = {}) {
     } else {
       const distDir = join2(result.projectPath, "dist");
       const publicDir = join2(result.projectPath, "public");
+      const staticDir = join2(result.projectPath, "static");
       if ((result.framework === "react" || result.framework === "nextjs") && existsSync2(distDir)) {
         finalOutputDir = distDir;
         console.log(
@@ -741,6 +764,13 @@ async function initCommand(options = {}) {
         );
       } else if (result.framework === "wordpress") {
         finalOutputDir = publicDir;
+      } else if ((result.framework === "django" || result.framework === "flask") && existsSync2(staticDir)) {
+        finalOutputDir = staticDir;
+        console.log(
+          chalk3.gray(
+            `  Using static/ directory (${result.framework} detected)`
+          )
+        );
       } else if (existsSync2(publicDir)) {
         finalOutputDir = publicDir;
       } else if (existsSync2(distDir)) {
@@ -772,6 +802,27 @@ async function initCommand(options = {}) {
         transaction.backupFile(swRelative);
       }
     }
+    const factory = getBackendFactory();
+    let backendIntegration = null;
+    if (factory && typeof factory === "object" && "detectBackend" in factory) {
+      backendIntegration = factory.detectBackend(result.projectPath) ?? null;
+    }
+    if (!backendIntegration && result.framework && factory && typeof factory === "object" && "getIntegration" in factory) {
+      backendIntegration = factory.getIntegration(
+        result.framework,
+        result.projectPath
+      );
+      if (backendIntegration && typeof backendIntegration === "object" && "detect" in backendIntegration) {
+        const detectionResult = backendIntegration.detect();
+        if (detectionResult && typeof detectionResult === "object") {
+          const detected = detectionResult.detected ?? false;
+          const confidence = detectionResult.confidence ?? "low";
+          if (!detected || confidence === "low") {
+            backendIntegration = null;
+          }
+        }
+      }
+    }
     console.log(chalk3.blue("\u{1F4DD} Generating manifest.json..."));
     const appName = name ?? (result.framework ? `${result.framework} App` : "My PWA");
     const normalizedShortName = shortName && typeof shortName === "string" && shortName.trim().length > 0 ? shortName.trim() : void 0;
@@ -863,18 +914,22 @@ async function initCommand(options = {}) {
     } catch {
       manifestId = appName.toLowerCase().replace(/[^a-z0-9-]/g, "-").substring(0, 20);
     }
+    const backendManifestDefaults = backendIntegration && typeof backendIntegration === "object" && "generateManifestVariables" in backendIntegration && typeof backendIntegration.generateManifestVariables === "function" ? mapBackendManifestVarsToOptions(
+      backendIntegration.generateManifestVariables()
+    ) : {};
     let manifestPath;
     try {
       if (iconPaths.length > 0) {
         const manifestWithIconsOptions = {
+          ...backendManifestDefaults,
           name: appName,
           shortName: finalShortName,
           id: manifestId,
           startUrl: finalBasePath,
           scope: finalBasePath,
           display: "standalone",
-          themeColor: themeColor ?? "#ffffff",
-          backgroundColor: backgroundColor ?? "#000000",
+          themeColor: themeColor ?? backendManifestDefaults.themeColor ?? "#ffffff",
+          backgroundColor: backgroundColor ?? backendManifestDefaults.backgroundColor ?? "#000000",
           icons: iconPaths.map((src) => ({
             src,
             sizes: src.match(/(\d+)x(\d+)/)?.[0] ?? "192x192",
@@ -905,14 +960,15 @@ async function initCommand(options = {}) {
           chalk3.yellow("\u26A0 Generating manifest with placeholder icon")
         );
         const manifestMinimalOptions = {
+          ...backendManifestDefaults,
           name: appName,
           shortName: finalShortName,
           id: manifestId,
           startUrl: finalBasePath,
           scope: finalBasePath,
           display: "standalone",
-          themeColor: themeColor ?? "#ffffff",
-          backgroundColor: backgroundColor ?? "#000000",
+          themeColor: themeColor ?? backendManifestDefaults.themeColor ?? "#ffffff",
+          backgroundColor: backgroundColor ?? backendManifestDefaults.backgroundColor ?? "#000000",
           icons: [
             {
               src: "/icon-192x192.png",
@@ -953,24 +1009,6 @@ async function initCommand(options = {}) {
     if (!skipServiceWorker) {
       console.log(chalk3.blue("\u2699\uFE0F Generating service worker..."));
       try {
-        const factory = getBackendFactory();
-        let backendIntegration = null;
-        if (factory && typeof factory === "object" && "detectBackend" in factory) {
-          backendIntegration = factory.detectBackend(result.projectPath);
-        }
-        if (!backendIntegration && result.framework && factory && typeof factory === "object" && "getIntegration" in factory) {
-          backendIntegration = factory.getIntegration(result.framework, result.projectPath);
-          if (backendIntegration && typeof backendIntegration === "object" && "detect" in backendIntegration) {
-            const detectionResult = backendIntegration.detect();
-            if (detectionResult && typeof detectionResult === "object") {
-              const detected = detectionResult.detected ?? false;
-              const confidence = detectionResult.confidence ?? "low";
-              if (!detected || confidence === "low") {
-                backendIntegration = null;
-              }
-            }
-          }
-        }
         let swResult;
         if (backendIntegration && typeof backendIntegration === "object" && "detect" in backendIntegration && "name" in backendIntegration) {
           const detectionResult = backendIntegration.detect();
@@ -1085,16 +1123,33 @@ async function initCommand(options = {}) {
     if (!skipInjection) {
       console.log(chalk3.blue("\u{1F489} Injecting meta-tags..."));
       try {
-        const htmlFiles = await glob("**/*.{html,twig,html.twig,blade.php}", {
-          cwd: result.projectPath,
-          ignore: [
-            "**/node_modules/**",
-            "**/.next/**",
-            "**/.nuxt/**",
-            "**/vendor/**"
-          ],
-          absolute: true
-        });
+        const useWordPressRestricted = result.framework === "wordpress" && !(htmlExtensions && htmlExtensions.length > 0);
+        let htmlFiles;
+        if (useWordPressRestricted) {
+          htmlFiles = await glob([...WORDPRESS_INJECTION_PATTERNS], {
+            cwd: result.projectPath,
+            ignore: [
+              "**/node_modules/**",
+              "**/.next/**",
+              "**/.nuxt/**",
+              "**/vendor/**"
+            ],
+            absolute: true
+          });
+        } else {
+          const injectionExts = htmlExtensions && htmlExtensions.length > 0 ? htmlExtensions : [...DEFAULT_INJECTION_EXTENSIONS];
+          const htmlGlobPattern = injectionExts.length > 0 ? `**/*.{${injectionExts.join(",")}}` : "**/*.html";
+          htmlFiles = await glob(htmlGlobPattern, {
+            cwd: result.projectPath,
+            ignore: [
+              "**/node_modules/**",
+              "**/.next/**",
+              "**/.nuxt/**",
+              "**/vendor/**"
+            ],
+            absolute: true
+          });
+        }
         htmlFiles.sort((a, b) => {
           const aInDist = a.includes("/dist/");
           const bInDist = b.includes("/dist/");
@@ -1117,10 +1172,15 @@ async function initCommand(options = {}) {
           const bladeCount = htmlFiles.filter(
             (f) => f.endsWith(".blade.php")
           ).length;
+          const wpThemeCount = useWordPressRestricted ? htmlFiles.filter(
+            (f) => f.endsWith("header.php") || f.endsWith("footer.php")
+          ).length : 0;
           const fileTypes = [];
           if (htmlCount > 0) fileTypes.push(`${htmlCount} HTML`);
           if (twigCount > 0) fileTypes.push(`${twigCount} Twig`);
           if (bladeCount > 0) fileTypes.push(`${bladeCount} Blade`);
+          if (wpThemeCount > 0)
+            fileTypes.push(`${wpThemeCount} WordPress theme`);
           const typeSummary = fileTypes.length > 0 ? ` (${fileTypes.join(", ")})` : "";
           console.log(
             chalk3.gray(
@@ -1924,7 +1984,9 @@ async function generateConfigCommand(options = {}) {
         }
       ]);
       if (!overwrite) {
-        result.errors.push("Configuration file already exists and overwrite was cancelled");
+        result.errors.push(
+          "Configuration file already exists and overwrite was cancelled"
+        );
         return result;
       }
     }
@@ -2567,7 +2629,7 @@ async function promptInitOptions(projectPath, framework, architecture = null) {
 // package.json
 var package_default = {
   name: "@julien-lin/universal-pwa-cli",
-  version: "1.3.14",
+  version: "1.3.16",
   description: "CLI to transform any web project into a PWA",
   keywords: [
     "pwa",
@@ -2664,7 +2726,7 @@ var normalizeConfigFormat = (value) => {
   throw new Error(`Invalid format: ${value ?? "undefined"}`);
 };
 program.name("universal-pwa").description("Transform any web project into a PWA with one click").version(version);
-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").option("--force-scan", "Force scan (bypass cache)").option("--no-cache", "Disable cache").option("--max-html-files <number>", "Maximum number of HTML files to process (default: unlimited)", (value) => Number.parseInt(value, 10)).action(async (options) => {
+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").option("--force-scan", "Force scan (bypass cache)").option("--no-cache", "Disable cache").option("--max-html-files <number>", "Maximum number of HTML files to process (default: unlimited)", (value) => Number.parseInt(value, 10)).option("--html-extensions <extensions>", "Comma-separated HTML/template extensions (e.g. html,twig,blade.php,j2)", (value) => value ? value.split(",").map((s) => s.trim()).filter(Boolean) : void 0).action(async (options) => {
   try {
     const projectPath = options.projectPath ?? process.cwd();
     const hasOptions = options.name || options.shortName || options.iconSource || options.themeColor || options.backgroundColor || options.skipIcons !== void 0;
@@ -2723,7 +2785,8 @@ program.command("init").description("Initialize PWA in your project").option("-p
       outputDir: finalOptions.outputDir,
       forceScan: options.forceScan,
       noCache: options.noCache,
-      maxHtmlFiles: options.maxHtmlFiles
+      maxHtmlFiles: options.maxHtmlFiles,
+      htmlExtensions: options.htmlExtensions
     });
     process.exit(result.success ? 0 : 1);
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@julien-lin/universal-pwa-cli",
-  "version": "1.3.14",
+  "version": "1.3.16",
   "description": "CLI to transform any web project into a PWA",
   "keywords": [
     "pwa",
@@ -66,7 +66,7 @@
     "string-width": "^8.1.1",
     "strip-ansi": "^7.1.2",
     "zod": "^4.3.6",
-    "@julien-lin/universal-pwa-core": "^1.3.14"
+    "@julien-lin/universal-pwa-core": "^1.3.16"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",