feat: Add Next.js/React offline error handling and improve package configuration

- Add comprehensive error boundary for React/Next.js applications in offline mode
- Enhance .npmignore with additional Claude-related exclusions
- Update README.md to mention Next.js/React error handling feature
- Clean up package.json files array to remove non-existent IMPLEMENTATION.md

Author: SanjeevSaniel

.claude/settings.local.json

@@ -7,7 +7,8 @@
       "Bash(timeout:*)",
       "Bash(npm install)",
       "Bash(npm install:*)",
-      "Bash(grep:*)"
+      "Bash(grep:*)",
+      "Bash(npm pack:*)"
     ],
     "additionalDirectories": [
       "D:\\d\\1A-Personal\\D-Learnings\\1-Projects"

.npmignore

@@ -1,5 +1,6 @@
 # Development files
 .claude/
+.claude
 .git/
 .gitignore
 .env
@@ -8,6 +9,10 @@
 # Development documentation
 CLAUDE.local.md
 CLAUDE.md
+CLAUDE.*
+IMPLEMENTATION.md
+claude-*
+Claude-*
 
 # Test outputs and temporary files
 test-output/
@@ -58,4 +63,4 @@ build/
 
 # Temporary folders
 tmp/
-temp/
+temp/

README.md

@@ -29,6 +29,7 @@ A powerful, universal website mirroring tool that intelligently detects and pres
 - Optional tracking script removal (analytics, GTM, Facebook Pixel)
 - Professional project structure ready for development
 - Offline-ready websites with localized resources
+- **Next.js/React error handling** for graceful offline operation
 
 ## 🚀 Quick Start
 

package.json

@@ -82,8 +82,7 @@
   "files": [
     "src/",
     "README.md",
-    "LICENSE",
-    "IMPLEMENTATION.md"
+    "LICENSE"
   ],
   "preferGlobal": true,
   "os": [

src/core/framework-writer.js

@@ -9,6 +9,133 @@ export class FrameworkWriter {
     this.assetMappings = new Map(); // absolute URL (and alternates) -> local ./assets/... path
   }
 
+  /**
+   * Adds error handling for Next.js/React applications in offline mode
+   * @param {Object} $ - Cheerio DOM instance
+   */
+  addOfflineErrorHandling($) {
+    // Detect if this is a Next.js application
+    const isNextJs = this.cloner.analysis?.primaryFramework?.key === 'nextjs' || 
+                     $('#__next').length > 0 || 
+                     $('script[src*="_next"]').length > 0;
+    
+    const isReact = this.cloner.analysis?.primaryFramework?.key === 'react' || 
+                    $('#root').length > 0 || 
+                    $('script[src*="react"]').length > 0;
+
+    if (isNextJs || isReact) {
+      // Add error boundary script for React/Next.js applications
+      const errorBoundaryScript = `
+<script>
+(function() {
+  // Global error handler for React/Next.js offline mode
+  window.addEventListener('error', function(event) {
+    console.warn('Mirror Web CLI: Handling offline error:', event.error?.message || event.message);
+    
+    // Hide the default Next.js error overlay
+    const errorOverlay = document.querySelector('[data-nextjs-dialog-overlay]');
+    if (errorOverlay) {
+      errorOverlay.style.display = 'none';
+    }
+    
+    // Check if the app root is empty and show a fallback
+    const appRoot = document.querySelector('#__next, #root, [data-reactroot]');
+    if (appRoot && (!appRoot.innerHTML || appRoot.innerHTML.trim() === '')) {
+      appRoot.innerHTML = \`
+        <div style="
+          min-height: 100vh; 
+          display: flex; 
+          align-items: center; 
+          justify-content: center; 
+          flex-direction: column;
+          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+          background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+          color: white;
+          text-align: center;
+          padding: 2rem;
+        ">
+          <div style="
+            background: rgba(255,255,255,0.1);
+            backdrop-filter: blur(10px);
+            border-radius: 20px;
+            padding: 3rem;
+            max-width: 600px;
+            box-shadow: 0 8px 32px rgba(0,0,0,0.1);
+          ">
+            <h1 style="margin: 0 0 1rem 0; font-size: 2.5rem; font-weight: 300;">
+              🪞 Offline Mirror
+            </h1>
+            <p style="margin: 0 0 1.5rem 0; font-size: 1.2rem; opacity: 0.9;">
+              This is an offline mirror of <strong>${this.cloner.url}</strong>
+            </p>
+            <p style="margin: 0; font-size: 1rem; opacity: 0.7;">
+              Some interactive features may not work in offline mode.<br>
+              This static mirror preserves the visual content and structure.
+            </p>
+            <div style="margin-top: 2rem; font-size: 0.9rem; opacity: 0.6;">
+              Generated by Mirror Web CLI v1.0
+            </div>
+          </div>
+        </div>
+      \`;
+    }
+    
+    return true; // Prevent default error handling
+  });
+  
+  // Handle unhandled promise rejections
+  window.addEventListener('unhandledrejection', function(event) {
+    console.warn('Mirror Web CLI: Handling offline promise rejection:', event.reason);
+    event.preventDefault(); // Prevent default handling
+  });
+  
+  // Override fetch for offline mode
+  if (typeof window.fetch !== 'undefined') {
+    const originalFetch = window.fetch;
+    window.fetch = function(...args) {
+      return originalFetch(...args).catch(error => {
+        console.warn('Mirror Web CLI: Network request failed in offline mode:', args[0]);
+        // Return a fake response to prevent crashes
+        return new Response('Offline mode - network request blocked', {
+          status: 200,
+          statusText: 'OK',
+          headers: { 'Content-Type': 'text/plain' }
+        });
+      });
+    };
+  }
+})();
+</script>`;
+
+      // Add the error handling script to the head
+      $('head').append(errorBoundaryScript);
+      
+      // Add a noscript fallback
+      const noscriptFallback = `
+<noscript>
+  <div style="
+    min-height: 100vh; 
+    display: flex; 
+    align-items: center; 
+    justify-content: center; 
+    flex-direction: column;
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+    background: #f8fafc;
+    color: #334155;
+    text-align: center;
+    padding: 2rem;
+  ">
+    <h1>🪞 Offline Mirror</h1>
+    <p>This is an offline mirror of <strong>${this.cloner.url}</strong></p>
+    <p>JavaScript is required to view this React/Next.js application.</p>
+    <p>Please enable JavaScript in your browser settings.</p>
+  </div>
+</noscript>`;
+
+      $('body').prepend(noscriptFallback);
+    }
+  }
+
   async generateOfflineProject() {
     await fs.ensureDir(this.cloner.options.outputDir);
 
@@ -150,6 +277,9 @@ export class FrameworkWriter {
     $('head').append(
       `<meta name="mirrored-date" content="${new Date().toISOString()}">`,
     );
+    
+    // Add Next.js/React error handling for offline mode
+    this.addOfflineErrorHandling($);
 
     // Stylesheets
     $('link[rel="stylesheet"], link[rel="preload"][as="style"]').each(