make-folder-txt 2.2.0 → 2.2.1

package/make-folder-txt.txt

@@ -0,0 +1,1577 @@
+================================================================================
+START OF FOLDER: make-folder-txt
+================================================================================
+
+================================================================================
+PROJECT STRUCTURE
+================================================================================
+Root: C:\Programming\make-folder-txt
+
+make-folder-txt/
+├── .git/  [skipped]
+├── bin/
+│   └── make-folder-txt.js
+├── .txtconfig
+├── LICENSE
+├── package.json
+└── README.md
+
+Total files: 5
+
+================================================================================
+FILE CONTENTS
+================================================================================
+
+--------------------------------------------------------------------------------
+FILE: /bin/make-folder-txt.js
+--------------------------------------------------------------------------------
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { version } = require("../package.json");
+const { execSync } = require("child_process");
+
+// ── config ────────────────────────────────────────────────────────────────────
+const IGNORE_DIRS = new Set(["node_modules", ".git", ".next", "dist", "build", ".cache"]);
+const IGNORE_FILES = new Set([".DS_Store", "Thumbs.db", "desktop.ini", ".txtignore"]);
+
+const BINARY_EXTS = new Set([
+  ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".svg", ".webp",
+  ".pdf", ".zip", ".tar", ".gz", ".rar", ".7z",
+  ".exe", ".dll", ".so", ".dylib", ".bin",
+  ".mp3", ".mp4", ".wav", ".avi", ".mov",
+  ".woff", ".woff2", ".ttf", ".eot", ".otf",
+  ".lock",
+]);
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function readTxtIgnore(rootDir) {
+  const txtIgnorePath = path.join(rootDir, '.txtignore');
+  const ignorePatterns = new Set();
+  
+  try {
+    const content = fs.readFileSync(txtIgnorePath, 'utf8');
+    const lines = content.split('\n')
+      .map(line => line.trim())
+      .filter(line => line && !line.startsWith('#'));
+    
+    lines.forEach(line => ignorePatterns.add(line));
+  } catch (err) {
+    // .txtignore doesn't exist or can't be read - that's fine
+  }
+  
+  return ignorePatterns;
+}
+
+function copyToClipboard(text) {
+  try {
+    if (process.platform === 'win32') {
+      // Windows
+      execSync(`echo ${JSON.stringify(text).replace(/"/g, '""')} | clip`, { stdio: 'ignore' });
+    } else if (process.platform === 'darwin') {
+      // macOS
+      execSync(`echo ${JSON.stringify(text)} | pbcopy`, { stdio: 'ignore' });
+    } else {
+      // Linux (requires xclip or xsel)
+      try {
+        execSync(`echo ${JSON.stringify(text)} | xclip -selection clipboard`, { stdio: 'ignore' });
+      } catch {
+        try {
+          execSync(`echo ${JSON.stringify(text)} | xsel --clipboard --input`, { stdio: 'ignore' });
+        } catch {
+          console.warn('⚠️  Could not copy to clipboard. Install xclip or xsel on Linux.');
+          return false;
+        }
+      }
+    }
+    return true;
+  } catch (err) {
+    console.warn('⚠️  Could not copy to clipboard:', err.message);
+    return false;
+  }
+}
+
+function collectFiles(
+  dir,
+  rootDir,
+  ignoreDirs,
+  ignoreFiles,
+  onlyFolders,
+  onlyFiles,
+  options = {},
+) {
+  const {
+    indent = "",
+    lines = [],
+    filePaths = [],
+    inSelectedFolder = false,
+    hasOnlyFilters = false,
+    rootName = "",
+    txtIgnore = new Set(),
+    force = false,
+  } = options;
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return { lines, filePaths, hasIncluded: false };
+  }
+
+  entries.sort((a, b) => {
+    if (a.isDirectory() === b.isDirectory()) return a.name.localeCompare(b.name);
+    return a.isDirectory() ? -1 : 1;
+  });
+
+  entries.forEach((entry, idx) => {
+    const isLast = idx === entries.length - 1;
+    const connector = isLast ? "└── " : "├── ";
+    const childIndent = indent + (isLast ? "    " : "│   ");
+
+    if (entry.isDirectory()) {
+      if (!force && ignoreDirs.has(entry.name)) {
+        if (!hasOnlyFilters) {
+          lines.push(`${indent}${connector}${entry.name}/  [skipped]`);
+        }
+        return;
+      }
+
+      // Get relative path for .txtignore pattern matching
+      const relPathForIgnore = path.relative(rootDir, path.join(dir, entry.name)).split(path.sep).join("/");
+      
+      // Check against .txtignore patterns (both dirname and relative path) unless force is enabled
+      if (!force && (txtIgnore.has(entry.name) || txtIgnore.has(`${entry.name}/`) || txtIgnore.has(relPathForIgnore) || txtIgnore.has(`${relPathForIgnore}/`) || txtIgnore.has(`/${relPathForIgnore}/`))) {
+        if (!hasOnlyFilters) {
+          lines.push(`${indent}${connector}${entry.name}/  [skipped]`);
+        }
+        return;
+      }
+
+      const childPath = path.join(dir, entry.name);
+      const childInSelectedFolder = inSelectedFolder || onlyFolders.has(entry.name);
+      const childLines = [];
+      const childFiles = [];
+      const child = collectFiles(
+        childPath,
+        rootDir,
+        ignoreDirs,
+        ignoreFiles,
+        onlyFolders,
+        onlyFiles,
+        {
+          indent: childIndent,
+          lines: childLines,
+          filePaths: childFiles,
+          inSelectedFolder: childInSelectedFolder,
+          hasOnlyFilters,
+          rootName,
+          txtIgnore,
+          force,
+        },
+      );
+
+      const explicitlySelectedFolder = hasOnlyFilters && onlyFolders.has(entry.name);
+      const shouldIncludeDir = !hasOnlyFilters || child.hasIncluded || explicitlySelectedFolder;
+
+      if (shouldIncludeDir) {
+        lines.push(`${indent}${connector}${entry.name}/`);
+        lines.push(...child.lines);
+        filePaths.push(...child.filePaths);
+      }
+    } else {
+      if (!force && ignoreFiles.has(entry.name)) return;
+
+      // Get relative path for .txtignore pattern matching
+      const relPathForIgnore = path.relative(rootDir, path.join(dir, entry.name)).split(path.sep).join("/");
+      
+      // Check against .txtignore patterns (both filename and relative path) unless force is enabled
+      if (!force && (txtIgnore.has(entry.name) || txtIgnore.has(relPathForIgnore) || txtIgnore.has(`/${relPathForIgnore}`))) {
+        return;
+      }
+
+      // Ignore .txt files that match the folder name (e.g., foldername.txt) unless force is enabled
+      if (!force && entry.name.endsWith('.txt') && entry.name === `${rootName}.txt`) return;
+
+      const shouldIncludeFile = !hasOnlyFilters || inSelectedFolder || onlyFiles.has(entry.name);
+      if (!shouldIncludeFile) return;
+
+      lines.push(`${indent}${connector}${entry.name}`);
+      const relPath = "/" + path.relative(rootDir, path.join(dir, entry.name)).split(path.sep).join("/");
+      filePaths.push({ abs: path.join(dir, entry.name), rel: relPath });
+    }
+  });
+
+  return { lines, filePaths, hasIncluded: filePaths.length > 0 || lines.length > 0 };
+}
+
+function parseFileSize(sizeStr) {
+  const units = {
+    'B': 1,
+    'KB': 1024,
+    'MB': 1024 * 1024,
+    'GB': 1024 * 1024 * 1024,
+    'TB': 1024 * 1024 * 1024 * 1024
+  };
+  
+  const match = sizeStr.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB|TB)$/i);
+  if (!match) {
+    console.error(`Error: Invalid size format "${sizeStr}". Use format like "500KB", "2MB", "1GB".`);
+    process.exit(1);
+  }
+  
+  const value = parseFloat(match[1]);
+  const unit = match[2].toUpperCase();
+  return Math.floor(value * units[unit]);
+}
+
+function readContent(absPath, force = false, maxFileSize = 500 * 1024) {
+  const ext = path.extname(absPath).toLowerCase();
+  if (!force && BINARY_EXTS.has(ext)) return "[binary / skipped]";
+  try {
+    const stat = fs.statSync(absPath);
+    if (!force && stat.size > maxFileSize) {
+      const sizeStr = stat.size < 1024 ? `${stat.size} B` : 
+                     stat.size < 1024 * 1024 ? `${(stat.size / 1024).toFixed(1)} KB` :
+                     stat.size < 1024 * 1024 * 1024 ? `${(stat.size / (1024 * 1024)).toFixed(1)} MB` :
+                     `${(stat.size / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+      return `[file too large: ${sizeStr} – skipped]`;
+    }
+    return fs.readFileSync(absPath, "utf8");
+  } catch (err) {
+    return `[could not read file: ${err.message}]`;
+  }
+}
+
+function splitByFolders(treeLines, filePaths, rootName, effectiveMaxSize, forceFlag) {
+  const folders = new Map();
+  
+  // Group files by folder
+  filePaths.forEach(({ abs, rel }) => {
+    const folderPath = path.dirname(rel);
+    const folderKey = folderPath === '/' ? rootName : folderPath.slice(1);
+    
+    if (!folders.has(folderKey)) {
+      folders.set(folderKey, []);
+    }
+    folders.get(folderKey).push({ abs, rel });
+  });
+  
+  const results = [];
+  
+  folders.forEach((files, folderName) => {
+    const out = [];
+    const divider = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+    
+    out.push(divider);
+    out.push(`START OF FOLDER: ${folderName}`);
+    out.push(divider);
+    out.push("");
+    
+    // Add folder structure (only this folder's structure)
+    const folderTreeLines = treeLines.filter(line => 
+      line.includes(folderName + '/') || line === `${rootName}/`
+    );
+    
+    out.push(divider);
+    out.push("PROJECT STRUCTURE");
+    out.push(divider);
+    out.push(`Root: ${folderPath}\n`);
+    out.push(`${rootName}/`);
+    folderTreeLines.forEach(l => out.push(l));
+    out.push("");
+    out.push(`Total files in this folder: ${files.length}`);
+    out.push("");
+    
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+    
+    files.forEach(({ abs, rel }) => {
+      out.push("");
+      out.push(subDivider);
+      out.push(`FILE: ${rel}`);
+      out.push(subDivider);
+      out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    });
+    
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FOLDER: ${folderName}`);
+    out.push(divider);
+    
+    const fileName = `${rootName}-${folderName.replace(/[\/\\]/g, '-')}.txt`;
+    const filePath = path.join(process.cwd(), fileName);
+    
+    fs.writeFileSync(filePath, out.join("\n"), "utf8");
+    const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+    
+    results.push({
+      file: filePath,
+      size: sizeKB,
+      files: files.length,
+      folder: folderName
+    });
+  });
+  
+  return results;
+}
+
+function splitByFiles(filePaths, rootName, effectiveMaxSize, forceFlag) {
+  const results = [];
+  
+  filePaths.forEach(({ abs, rel }) => {
+    const out = [];
+    const divider = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+    const fileName = path.basename(rel, path.extname(rel));
+    
+    out.push(divider);
+    out.push(`FILE: ${rel}`);
+    out.push(divider);
+    out.push("");
+    
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+    out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FILE: ${rel}`);
+    out.push(divider);
+    
+    const outputFileName = `${rootName}-${fileName}.txt`;
+    const filePath = path.join(process.cwd(), outputFileName);
+    
+    fs.writeFileSync(filePath, out.join("\n"), "utf8");
+    const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+    
+    results.push({
+      file: filePath,
+      size: sizeKB,
+      files: 1,
+      fileName: fileName
+    });
+  });
+  
+  return results;
+}
+
+function splitBySize(treeLines, filePaths, rootName, splitSize, effectiveMaxSize, forceFlag) {
+  const results = [];
+  let currentPart = 1;
+  let currentSize = 0;
+  let currentFiles = [];
+  
+  const divider = "=".repeat(80);
+  const subDivider = "-".repeat(80);
+  
+  // Start with header
+  let out = [];
+  out.push(divider);
+  out.push(`START OF FOLDER: ${rootName} (Part ${currentPart})`);
+  out.push(divider);
+  out.push("");
+  
+  out.push(divider);
+  out.push("PROJECT STRUCTURE");
+  out.push(divider);
+  out.push(`Root: ${folderPath}\n`);
+  out.push(`${rootName}/`);
+  treeLines.forEach(l => out.push(l));
+  out.push("");
+  out.push(`Total files: ${filePaths.length}`);
+  out.push("");
+  
+  out.push(divider);
+  out.push("FILE CONTENTS");
+  out.push(divider);
+  
+  filePaths.forEach(({ abs, rel }) => {
+    const content = readContent(abs, forceFlag, effectiveMaxSize);
+    const fileContent = [
+      "",
+      subDivider,
+      `FILE: ${rel}`,
+      subDivider,
+      content
+    ];
+    
+    const contentSize = fileContent.join("\n").length;
+    
+    // Check if adding this file would exceed the split size
+    if (currentSize + contentSize > splitSize && currentFiles.length > 0) {
+      // Finish current part
+      out.push("");
+      out.push(divider);
+      out.push(`END OF FOLDER: ${rootName} (Part ${currentPart})`);
+      out.push(divider);
+      
+      // Write current part
+      const fileName = `${rootName}-part-${currentPart}.txt`;
+      const filePath = path.join(process.cwd(), fileName);
+      fs.writeFileSync(filePath, out.join("\n"), "utf8");
+      const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+      
+      results.push({
+        file: filePath,
+        size: sizeKB,
+        files: currentFiles.length,
+        part: currentPart
+      });
+      
+      // Start new part
+      currentPart++;
+      currentSize = 0;
+      currentFiles = [];
+      
+      out = [];
+      out.push(divider);
+      out.push(`START OF FOLDER: ${rootName} (Part ${currentPart})`);
+      out.push(divider);
+      out.push("");
+      
+      out.push(divider);
+      out.push("PROJECT STRUCTURE");
+      out.push(divider);
+      out.push(`Root: ${folderPath}\n`);
+      out.push(`${rootName}/`);
+      treeLines.forEach(l => out.push(l));
+      out.push("");
+      out.push(`Total files: ${filePaths.length}`);
+      out.push("");
+      
+      out.push(divider);
+      out.push("FILE CONTENTS");
+      out.push(divider);
+    }
+    
+    // Add file to current part
+    out.push(...fileContent);
+    currentSize += contentSize;
+    currentFiles.push(rel);
+  });
+  
+  // Write final part
+  out.push("");
+  out.push(divider);
+  out.push(`END OF FOLDER: ${rootName} (Part ${currentPart})`);
+  out.push(divider);
+  
+  const fileName = `${rootName}-part-${currentPart}.txt`;
+  const filePath = path.join(process.cwd(), fileName);
+  fs.writeFileSync(filePath, out.join("\n"), "utf8");
+  const sizeKB = (fs.statSync(filePath).size / 1024).toFixed(1);
+  
+  results.push({
+    file: filePath,
+    size: sizeKB,
+    files: currentFiles.length,
+    part: currentPart
+  });
+  
+  return results;
+}
+
+// ── configuration ────────────────────────────────────────────────────────────────
+
+function createInteractiveConfig() {
+  const readline = require('readline');
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  console.log('\n🔧 make-folder-txt Configuration Setup');
+  console.log('=====================================\n');
+
+  return new Promise((resolve) => {
+    const config = {
+      maxFileSize: '500KB',
+      splitMethod: 'none',
+      splitSize: '5MB',
+      copyToClipboard: false,
+      ignoreFolders: [],
+      ignoreFiles: []
+    };
+
+    let currentStep = 0;
+    const questions = [
+      {
+        key: 'maxFileSize',
+        question: 'Maximum file size to include (e.g., 500KB, 2MB, 1GB): ',
+        default: '500KB',
+        validate: (value) => {
+          if (!value.trim()) return true;
+          const validUnits = ['B', 'KB', 'MB', 'GB', 'TB'];
+          const match = value.match(/^(\d+(?:\.\d+)?)\s*([A-Z]+)$/i);
+          if (!match) return 'Please enter a valid size (e.g., 500KB, 2MB, 1GB)';
+          if (!validUnits.includes(match[2].toUpperCase())) return `Invalid unit. Use: ${validUnits.join(', ')}`;
+          return true;
+        }
+      },
+      {
+        key: 'splitMethod',
+        question: 'Split output method (none, folder, file, size): ',
+        default: 'none',
+        validate: (value) => {
+          const validMethods = ['none', 'folder', 'file', 'size'];
+          if (!validMethods.includes(value.toLowerCase())) return `Please choose: ${validMethods.join(', ')}`;
+          return true;
+        }
+      },
+      {
+        key: 'splitSize',
+        question: 'Split size when using size method (e.g., 5MB, 10MB): ',
+        default: '5MB',
+        ask: () => config.splitMethod === 'size',
+        validate: (value) => {
+          if (!value.trim()) return true;
+          const validUnits = ['B', 'KB', 'MB', 'GB', 'TB'];
+          const match = value.match(/^(\d+(?:\.\d+)?)\s*([A-Z]+)$/i);
+          if (!match) return 'Please enter a valid size (e.g., 5MB, 10MB)';
+          if (!validUnits.includes(match[2].toUpperCase())) return `Invalid unit. Use: ${validUnits.join(', ')}`;
+          return true;
+        }
+      },
+      {
+        key: 'copyToClipboard',
+        question: 'Copy to clipboard automatically? (y/n): ',
+        default: 'n',
+        validate: (value) => {
+          const answer = value.toLowerCase();
+          if (!['y', 'n', 'yes', 'no'].includes(answer)) return 'Please enter y/n or yes/no';
+          return true;
+        },
+        transform: (value) => ['y', 'yes'].includes(value.toLowerCase())
+      },
+      {
+        key: 'ignoreFolders',
+        question: 'Ignore folders (comma-separated, or press Enter to skip): ',
+        default: '',
+        transform: (value) => value ? value.split(',').map(f => f.trim()).filter(f => f) : []
+      },
+      {
+        key: 'ignoreFiles',
+        question: 'Ignore files (comma-separated, or press Enter to skip): ',
+        default: '',
+        transform: (value) => value ? value.split(',').map(f => f.trim()).filter(f => f) : []
+      }
+    ];
+
+    function askQuestion() {
+      if (currentStep >= questions.length) {
+        // Save configuration
+        saveConfig();
+        return;
+      }
+
+      const q = questions[currentStep];
+      
+      // Skip if conditional ask returns false
+      if (q.ask && !q.ask()) {
+        currentStep++;
+        askQuestion();
+        return;
+      }
+
+      const defaultValue = typeof q.default === 'function' ? q.default() : q.default;
+      rl.question(q.question + (defaultValue ? `(${defaultValue}) ` : ''), (answer) => {
+        const value = answer.trim() || defaultValue;
+        
+        // Validate input
+        if (q.validate) {
+          const validation = q.validate(value);
+          if (validation !== true) {
+            console.log(`❌ ${validation}`);
+            askQuestion();
+            return;
+          }
+        }
+
+        // Transform value if needed
+        if (q.transform) {
+          config[q.key] = q.transform(value);
+        } else {
+          config[q.key] = value;
+        }
+
+        currentStep++;
+        askQuestion();
+      });
+    }
+
+    function saveConfig() {
+      try {
+        // Create .txtconfig file
+        const configPath = path.join(process.cwd(), '.txtconfig');
+        const configContent = `{
+  "maxFileSize": "${config.maxFileSize}",
+  "splitMethod": "${config.splitMethod}",
+  "splitSize": "${config.splitSize}",
+  "copyToClipboard": ${config.copyToClipboard},
+  "ignoreFolders": ${JSON.stringify(config.ignoreFolders)},
+  "ignoreFiles": ${JSON.stringify(config.ignoreFiles)}
+}`;
+
+        fs.writeFileSync(configPath, configContent);
+
+        // Update .txtignore if there are ignore patterns
+        if (config.ignoreFolders.length > 0 || config.ignoreFiles.length > 0) {
+          const ignorePath = path.join(process.cwd(), '.txtignore');
+          let ignoreContent = '';
+          
+          // Read existing content if file exists
+          if (fs.existsSync(ignorePath)) {
+            ignoreContent = fs.readFileSync(ignorePath, 'utf8');
+            if (!ignoreContent.endsWith('\n')) ignoreContent += '\n';
+          }
+
+          // Add new ignore patterns
+          const newPatterns = [
+            ...config.ignoreFolders.map(f => f.endsWith('/') ? f : `${f}/`),
+            ...config.ignoreFiles
+          ];
+
+          if (newPatterns.length > 0) {
+            ignoreContent += '\n# Added by make-folder-txt config\n';
+            ignoreContent += newPatterns.join('\n') + '\n';
+            fs.writeFileSync(ignorePath, ignoreContent);
+          }
+        }
+
+        console.log('\n✅ Configuration saved successfully!');
+        console.log(`📄 Config file: ${configPath}`);
+        if (config.ignoreFolders.length > 0 || config.ignoreFiles.length > 0) {
+          console.log(`📝 Ignore patterns added to .txtignore`);
+        }
+        console.log('\n💡 You can now run: make-folder-txt --use-config');
+
+      } catch (err) {
+        console.error('❌ Error saving configuration:', err.message);
+      } finally {
+        rl.close();
+        resolve();
+      }
+    }
+
+    askQuestion();
+  });
+}
+
+function loadConfig() {
+  const fs = require('fs');
+  const path = require('path');
+  
+  try {
+    const configPath = path.join(process.cwd(), '.txtconfig');
+    if (!fs.existsSync(configPath)) {
+      console.error('❌ .txtconfig file not found. Run --make-config first.');
+      process.exit(1);
+    }
+    
+    const configContent = fs.readFileSync(configPath, 'utf8');
+    return JSON.parse(configContent);
+  } catch (err) {
+    console.error('❌ Error loading configuration:', err.message);
+    process.exit(1);
+  }
+}
+
+// ── main ──────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes("-v") || args.includes("--version")) {
+    console.log(`v${version}`);
+    console.log("Built by Muhammad Saad Amin");
+    process.exit(0);
+  }
+
+  if (args.includes("--make-config")) {
+    await createInteractiveConfig();
+    process.exit(0);
+  }
+
+  if (args.includes("--use-config")) {
+    const config = loadConfig();
+    
+    // Apply config to command line arguments
+    const newArgs = [];
+    
+    // Add max file size if not default
+    if (config.maxFileSize !== '500KB') {
+      newArgs.push('--skip-large', config.maxFileSize);
+    }
+    
+    // Add split method if not none
+    if (config.splitMethod !== 'none') {
+      newArgs.push('--split-method', config.splitMethod);
+      if (config.splitMethod === 'size') {
+        newArgs.push('--split-size', config.splitSize);
+      }
+    }
+    
+    // Add copy to clipboard if true
+    if (config.copyToClipboard) {
+      newArgs.push('--copy');
+    }
+    
+    // Add ignore folders
+    if (config.ignoreFolders.length > 0) {
+      newArgs.push('--ignore-folder', ...config.ignoreFolders);
+    }
+    
+    // Add ignore files
+    if (config.ignoreFiles.length > 0) {
+      newArgs.push('--ignore-file', ...config.ignoreFiles);
+    }
+    
+    // Replace args with config-based args
+    args.splice(0, args.length, ...newArgs);
+  }
+
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(` 
+\x1b[33mmake-folder-txt\x1b[0m
+Dump an entire project folder into a single readable .txt file.
+
+\x1b[33mUSAGE\x1b[0m
+  make-folder-txt [options]
+
+\x1b[33mOPTIONS\x1b[0m
+  --ignore-folder, -ifo <names...>    Ignore specific folders by name
+  --ignore-file, -ifi <names...>      Ignore specific files by name
+  --only-folder, -ofo <names...>      Include only specific folders
+  --only-file, -ofi <names...>        Include only specific files
+  --skip-large <size>                 Skip files larger than specified size (default: 500KB)
+  --no-skip                           Include all files regardless of size
+  --split-method <method>             Split output: folder, file, or size
+  --split-size <size>                 Split output when size exceeds limit (requires --split-method size)
+  --copy                              Copy output to clipboard
+  --force                             Include everything (overrides all ignore patterns)
+  --make-config                       Create interactive configuration
+  --use-config                        Use configuration from .txtconfig file
+  --help, -h                          Show this help message
+  --version, -v                       Show version information
+
+\x1b[33mEXAMPLES\x1b[0m
+  make-folder-txt
+  make-folder-txt --copy
+  make-folder-txt --force
+  make-folder-txt --skip-large 400KB
+  make-folder-txt --skip-large 5GB
+  make-folder-txt --no-skip
+  make-folder-txt --split-method folder
+  make-folder-txt --split-method file
+  make-folder-txt --split-method size --split-size 5MB
+  make-folder-txt --ignore-folder node_modules dist
+  make-folder-txt -ifo node_modules dist
+  make-folder-txt --ignore-file .env .env.local
+  make-folder-txt -ifi .env .env.local
+  make-folder-txt --only-folder src docs
+  make-folder-txt -ofo src docs
+  make-folder-txt --only-file package.json README.md
+  make-folder-txt -ofi package.json README.md
+  make-folder-txt --make-config
+  make-folder-txt --use-config
+
+\x1b[33m.TXTIGNORE FILE\x1b[0m
+  Create a .txtignore file in your project root to specify files/folders to ignore.
+  Works like .gitignore - supports file names, path patterns, and comments.
+
+  Example .txtignore:
+    node_modules/
+    *.log
+    .env
+    coverage/
+    LICENSE
+`);
+      process.exit(0);
+    }
+
+    const ignoreDirs = new Set(IGNORE_DIRS);
+    const ignoreFiles = new Set(IGNORE_FILES);
+    const onlyFolders = new Set();
+    const onlyFiles = new Set();
+    let outputArg = null;
+    let copyToClipboardFlag = false;
+    let forceFlag = false;
+    let maxFileSize = 500 * 1024; // Default 500KB
+    let noSkipFlag = false;
+    let splitMethod = null; // 'folder', 'file', 'size'
+    let splitSize = null; // size in bytes
+
+    for (let i = 0; i < args.length; i += 1) {
+      const arg = args[i];
+
+      if (arg === "--copy") {
+        copyToClipboardFlag = true;
+        continue;
+      }
+
+      if (arg === "--force") {
+        forceFlag = true;
+        continue;
+      }
+
+      if (arg === "--no-skip") {
+        noSkipFlag = true;
+        continue;
+      }
+
+      if (arg === "--skip-large") {
+        if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+          console.error("Error: --skip-large requires a size value (e.g., 400KB, 5GB).");
+          process.exit(1);
+        }
+        maxFileSize = parseFileSize(args[i + 1]);
+        i += 1;
+        continue;
+      }
+
+      if (arg.startsWith("--skip-large=")) {
+        const value = arg.slice("--skip-large=".length);
+        if (!value) {
+          console.error("Error: --skip-large requires a size value (e.g., 400KB, 5GB).");
+          process.exit(1);
+        }
+        maxFileSize = parseFileSize(value);
+        continue;
+      }
+
+      if (arg === "--split-method") {
+        if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+          console.error("Error: --split-method requires a method (folder, file, or size).");
+          process.exit(1);
+        }
+        const method = args[i + 1].toLowerCase();
+        if (!['folder', 'file', 'size'].includes(method)) {
+          console.error("Error: --split-method must be one of: folder, file, size");
+          process.exit(1);
+        }
+        splitMethod = method;
+        i += 1;
+        continue;
+      }
+
+      if (arg.startsWith("--split-method=")) {
+        const value = arg.slice("--split-method=".length);
+        if (!value) {
+          console.error("Error: --split-method requires a method (folder, file, or size).");
+          process.exit(1);
+        }
+        const method = value.toLowerCase();
+        if (!['folder', 'file', 'size'].includes(method)) {
+          console.error("Error: --split-method must be one of: folder, file, size");
+          process.exit(1);
+        }
+        splitMethod = method;
+        continue;
+      }
+
+      if (arg === "--split-size") {
+        if (i + 1 >= args.length || args[i + 1].startsWith("-")) {
+          console.error("Error: --split-size requires a size value (e.g., 5MB, 10MB).");
+          process.exit(1);
+        }
+        splitSize = parseFileSize(args[i + 1]);
+        i += 1;
+        continue;
+      }
+
+      if (arg.startsWith("--split-size=")) {
+        const value = arg.slice("--split-size=".length);
+        if (!value) {
+          console.error("Error: --split-size requires a size value (e.g., 5MB, 10MB).");
+          process.exit(1);
+        }
+        splitSize = parseFileSize(value);
+        continue;
+      }
+
+      if (arg === "--ignore-folder" || arg === "-ifo") {
+        let consumed = 0;
+        while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          // Normalize the folder name: remove backslashes, trailing slashes, and leading ./
+          let folderName = args[i + 1];
+          folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
+          folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
+          folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
+          ignoreDirs.add(folderName);
+          i += 1;
+          consumed += 1;
+        }
+        if (consumed === 0) {
+          console.error("Error: --ignore-folder requires at least one folder name.");
+          process.exit(1);
+        }
+        continue;
+      }
+
+      if (arg.startsWith("--ignore-folder=") || arg.startsWith("-ifo=")) {
+        const value = arg.startsWith("--ignore-folder=") 
+          ? arg.slice("--ignore-folder=".length)
+          : arg.slice("-ifo=".length);
+        if (!value) {
+          console.error("Error: --ignore-folder requires a folder name.");
+          process.exit(1);
+        }
+        // Normalize the folder name
+        let folderName = value;
+        folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
+        folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
+        folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
+        ignoreDirs.add(folderName);
+        continue;
+      }
+
+      if (arg === "--ignore-file" || arg === "-ifi") {
+        let consumed = 0;
+        while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          ignoreFiles.add(args[i + 1]);
+          i += 1;
+          consumed += 1;
+        }
+        if (consumed === 0) {
+          console.error("Error: --ignore-file requires at least one file name.");
+          process.exit(1);
+        }
+        continue;
+      }
+
+      if (arg.startsWith("--ignore-file=") || arg.startsWith("-ifi=")) {
+        const value = arg.startsWith("--ignore-file=") 
+          ? arg.slice("--ignore-file=".length)
+          : arg.slice("-ifi=".length);
+        if (!value) {
+          console.error("Error: --ignore-file requires a file name.");
+          process.exit(1);
+        }
+        ignoreFiles.add(value);
+        continue;
+      }
+
+      if (arg === "--only-folder" || arg === "-ofo") {
+        let consumed = 0;
+        while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          // Normalize the folder name
+          let folderName = args[i + 1];
+          folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
+          folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
+          folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
+          onlyFolders.add(folderName);
+          i += 1;
+          consumed += 1;
+        }
+        if (consumed === 0) {
+          console.error("Error: --only-folder requires at least one folder name.");
+          process.exit(1);
+        }
+        continue;
+      }
+
+      if (arg.startsWith("--only-folder=") || arg.startsWith("-ofo=")) {
+        const value = arg.startsWith("--only-folder=") 
+          ? arg.slice("--only-folder=".length)
+          : arg.slice("-ofo=".length);
+        if (!value) {
+          console.error("Error: --only-folder requires a folder name.");
+          process.exit(1);
+        }
+        // Normalize the folder name
+        let folderName = value;
+        folderName = folderName.replace(/\\/g, '/'); // Convert backslashes to forward slashes
+        folderName = folderName.replace(/^\.?\//, ''); // Remove leading ./ or /
+        folderName = folderName.replace(/\/+$/, ''); // Remove trailing slashes
+        onlyFolders.add(folderName);
+        continue;
+      }
+
+      if (arg === "--only-file" || arg === "-ofi") {
+        let consumed = 0;
+        while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+          onlyFiles.add(args[i + 1]);
+          i += 1;
+          consumed += 1;
+        }
+        if (consumed === 0) {
+          console.error("Error: --only-file requires at least one file name.");
+          process.exit(1);
+        }
+        continue;
+      }
+
+      if (arg.startsWith("--only-file=") || arg.startsWith("-ofi=")) {
+        const value = arg.startsWith("--only-file=") 
+          ? arg.slice("--only-file=".length)
+          : arg.slice("-ofi=".length);
+        if (!value) {
+          console.error("Error: --only-file requires a file name.");
+          process.exit(1);
+        }
+        onlyFiles.add(value);
+        continue;
+      }
+
+      // Unknown argument
+      console.error(`Error: Unknown option "${arg}"`);
+      console.error("Use --help for available options.");
+      process.exit(1);
+    }
+
+    // Validate split options
+    if (splitMethod === 'size' && !splitSize) {
+      console.error("Error: --split-method size requires --split-size to be specified");
+      process.exit(1);
+    }
+
+    if (splitSize && splitMethod !== 'size') {
+      console.error("Error: --split-size can only be used with --split-method size");
+      process.exit(1);
+    }
+
+    // ── config ────────────────────────────────────────────────────────────────────────
+
+    const folderPath = process.cwd();
+    const rootName = path.basename(folderPath);
+    const txtIgnore = readTxtIgnore(folderPath);
+
+    // ── build tree & collect file paths ───────────────────────────────────────────────
+
+    const { lines: treeLines, filePaths } = collectFiles(
+      folderPath,
+      folderPath,
+      ignoreDirs,
+      ignoreFiles,
+      onlyFolders,
+      onlyFiles,
+      { rootName, txtIgnore, force: forceFlag }
+    );
+
+    // ── build output filename ───────────────────────────────────────────────────────────
+
+    let outputFile = outputArg || path.join(folderPath, `${rootName}.txt`);
+
+    // ── handle output splitting ─────────────────────────────────────────────────────────
+
+    const effectiveMaxSize = noSkipFlag ? Infinity : maxFileSize;
+
+    if (splitMethod) {
+      console.log(`🔧 Splitting output by: ${splitMethod}`);
+      
+      let results;
+      
+      if (splitMethod === 'folder') {
+        results = splitByFolders(treeLines, filePaths, rootName, effectiveMaxSize, forceFlag);
+      } else if (splitMethod === 'file') {
+        results = splitByFiles(filePaths, rootName, effectiveMaxSize, forceFlag);
+      } else if (splitMethod === 'size') {
+        results = splitBySize(treeLines, filePaths, rootName, splitSize, effectiveMaxSize, forceFlag);
+      }
+      
+      console.log(`✅  Done! Created ${results.length} split files:`);
+      console.log('');
+      
+      results.forEach((result, index) => {
+        if (splitMethod === 'folder') {
+          console.log(`📁  Folder: ${result.folder}`);
+        } else if (splitMethod === 'file') {
+          console.log(`📄  File: ${result.fileName}`);
+        } else if (splitMethod === 'size') {
+          console.log(`📦  Part ${result.part}`);
+        }
+        console.log(`📄  Output : ${result.file}`);
+        console.log(`📊  Size   : ${result.size} KB`);
+        console.log(`🗂️   Files  : ${result.files}`);
+        console.log('');
+      });
+      
+      if (copyToClipboardFlag) {
+        console.log('⚠️  --copy flag is not compatible with splitting - clipboard copy skipped');
+      }
+      
+      process.exit(0);
+    }
+
+    // ── build output (no splitting) ───────────────────────────────────────────────────
+    const out = [];
+    const divider    = "=".repeat(80);
+    const subDivider = "-".repeat(80);
+
+    out.push(divider);
+    out.push(`START OF FOLDER: ${rootName}`);
+    out.push(divider);
+    out.push("");
+
+    out.push(divider);
+    out.push("PROJECT STRUCTURE");
+    out.push(divider);
+    out.push(`Root: ${folderPath}\n`);
+
+    out.push(`${rootName}/`);
+    treeLines.forEach(l => out.push(l));
+    out.push("");
+    out.push(`Total files: ${filePaths.length}`);
+    out.push("");
+
+    out.push(divider);
+    out.push("FILE CONTENTS");
+    out.push(divider);
+
+    filePaths.forEach(({ abs, rel }) => {
+      out.push("");
+      out.push(subDivider);
+      out.push(`FILE: ${rel}`);
+      out.push(subDivider);
+      out.push(readContent(abs, forceFlag, effectiveMaxSize));
+    });
+
+    out.push("");
+    out.push(divider);
+    out.push(`END OF FOLDER: ${rootName}`);
+    out.push(divider);
+
+    fs.writeFileSync(outputFile, out.join("\n"), "utf8");
+
+    const sizeKB = (fs.statSync(outputFile).size / 1024).toFixed(1);
+    console.log(`✅  Done!`);
+    console.log(`📄  Output : ${outputFile}`);
+    console.log(`📊  Size   : ${sizeKB} KB`);
+    console.log(`🗂️   Files  : ${filePaths.length}`);
+
+    if (copyToClipboardFlag) {
+      const content = fs.readFileSync(outputFile, 'utf8');
+      const success = copyToClipboard(content);
+      if (success) {
+        console.log(`📋  Copied to clipboard!`);
+      }
+    }
+
+    console.log('');
+}
+
+// Run the main function
+main().catch(err => {
+  console.error('❌ Error:', err.message);
+  process.exit(1);
+});
+
+
+--------------------------------------------------------------------------------
+FILE: /.txtconfig
+--------------------------------------------------------------------------------
+{
+  "maxFileSize": "400KB",
+  "splitMethod": "none",
+  "splitSize": "5MB",
+  "copyToClipboard": false,
+  "ignoreFolders": ["skip"],
+  "ignoreFiles": ["skip"]
+}
+
+--------------------------------------------------------------------------------
+FILE: /LICENSE
+--------------------------------------------------------------------------------
+MIT License
+
+Copyright (c) 2026 Muhammad Saad Amin @SENODROOM
+
+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.
+
+
+--------------------------------------------------------------------------------
+FILE: /package.json
+--------------------------------------------------------------------------------
+{
+  "name": "make-folder-txt",
+  "version": "2.2.0",
+  "description": "Generate a single .txt file containing the full folder structure and file contents of any project, ignoring node_modules and other junk.",
+  "main": "bin/make-folder-txt.js",
+  "bin": {
+    "make-folder-txt": "bin/make-folder-txt.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "folder",
+    "dump",
+    "project",
+    "structure",
+    "txt",
+    "cli",
+    "export"
+  ],
+  "author": "Muhammad Saad Amin",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}
+
+
+--------------------------------------------------------------------------------
+FILE: /README.md
+--------------------------------------------------------------------------------
+<div align="center">
+
+# 📁 make-folder-txt
+
+**Instantly dump your entire project into a single, readable `.txt` file.**
+
+[![npm version](https://img.shields.io/npm/v/make-folder-txt?color=crimson&style=flat-square)](https://www.npmjs.com/package/make-folder-txt)
+[![npm downloads](https://img.shields.io/npm/dm/make-folder-txt?color=orange&style=flat-square)](https://www.npmjs.com/package/make-folder-txt)
+[![license](https://img.shields.io/npm/l/make-folder-txt?color=blue&style=flat-square)](./LICENSE)
+[![node](https://img.shields.io/node/v/make-folder-txt?color=green&style=flat-square)](https://nodejs.org)
+
+Perfect for sharing your codebase with **AI tools**, **teammates**, or **code reviewers** — without zipping files or giving repo access.
+
+[Installation](#-installation) · [Usage](#-usage) · [Help](#-get-help) · [Copy to Clipboard](#-copy-to-clipboard) · [Force Include Everything](#-force-include-everything) · [File Size Control](#-file-size-control) · [Output Splitting](#-output-splitting) · [Output Format](#-output-format) · [What Gets Skipped](#-what-gets-skipped) · [Contributing](#-contributing)
+
+</div>
+
+---
+
+## ✨ Why make-folder-txt?
+
+Ever needed to share your entire project with ChatGPT, Claude, or a teammate — but copy-pasting every file one by one is painful? **make-folder-txt** solves that in one command.
+
+- ✅ Run it from any project directory — no arguments needed
+- ✅ Built-in help system with `--help` flag
+- ✅ File size control with `--skip-large` and `--no-skip`
+- ✅ Output splitting by folders, files, or size
+- ✅ Copy to clipboard with `--copy` flag
+- ✅ Force include everything with `--force` flag
+- ✅ Generates a clean folder tree + every file's content
+- ✅ `.txtignore` support (works like `.gitignore`)
+- ✅ Automatically skips `node_modules`, binaries, and junk files
+- ✅ Zero dependencies — pure Node.js
+- ✅ Works on Windows, macOS, and Linux
+
+---
+
+## 📦 Installation
+
+Install globally once, use anywhere:
+
+```bash
+npm install -g make-folder-txt
+```
+
+---
+
+## 🚀 Usage
+
+Navigate into your project folder and run:
+
+```bash
+cd my-project
+make-folder-txt
+```
+
+That's it. A `my-project.txt` file will be created in the same directory.
+
+### 📖 Get Help
+
+```bash
+make-folder-txt --help      # Show all options and examples
+make-folder-txt -h          # Short version of help
+make-folder-txt --version   # Show version info
+make-folder-txt -v          # Short version of version
+```
+
+### 📋 Copy to Clipboard
+
+```bash
+make-folder-txt --copy      # Generate output and copy to clipboard
+make-folder-txt --copy --ignore-folder node_modules  # Copy filtered output
+```
+
+The `--copy` flag automatically copies the generated output to your system clipboard, making it easy to paste directly into AI tools, emails, or documents. Works on Windows, macOS, and Linux (requires `xclip` or `xsel` on Linux).
+
+### 🔥 Force Include Everything
+
+```bash
+make-folder-txt --force      # Include everything (overrides all ignore patterns)
+make-folder-txt --force --copy  # Include everything and copy to clipboard
+```
+
+The `--force` flag overrides all ignore patterns and includes:
+- `node_modules` and other ignored folders
+- Binary files (images, executables, etc.)
+- Large files (no 500 KB limit)
+- Files in `.txtignore`
+- System files and other normally skipped content
+
+Use this when you need a complete, unfiltered dump of your entire project.
+
+### 📏 File Size Control
+
+```bash
+make-folder-txt --skip-large 400KB     # Skip files larger than 400KB
+make-folder-txt --skip-large 5GB       # Skip files larger than 5GB
+make-folder-txt --skip-large 1.5MB     # Skip files larger than 1.5MB
+make-folder-txt --no-skip               # Include all files regardless of size
+```
+
+**Default behavior**: Files larger than 500KB are skipped by default.
+
+**Supported size units**:
+- **B** - Bytes
+- **KB** - Kilobytes (1024 bytes)
+- **MB** - Megabytes (1024 KB)
+- **GB** - Gigabytes (1024 MB)
+- **TB** - Terabytes (1024 GB)
+
+**Examples:**
+```bash
+# More restrictive - skip anything over 100KB
+make-folder-txt --skip-large 100KB
+
+# More permissive - allow files up to 10MB
+make-folder-txt --skip-large 10MB
+
+# Include everything - no size limits
+make-folder-txt --no-skip
+
+# Combine with other options
+make-folder-txt --skip-large 2MB --ignore-folder node_modules
+```
+
+**Size format**: Accepts decimal numbers (e.g., `1.5MB`, `0.5GB`) and various units.
+
+### 📂 Output Splitting
+
+```bash
+make-folder-txt --split-method folder    # Split by folders
+make-folder-txt --split-method file      # Split by files  
+make-folder-txt --split-method size --split-size 5MB  # Split by file size
+```
+
+**Split Methods:**
+- **`folder`** - Creates separate files for each folder
+- **`file`** - Creates separate files for each individual file
+- **`size`** - Splits output when content exceeds specified size
+
+**Examples:**
+```bash
+# Split by folders - creates folder-name.txt for each folder
+make-folder-txt --split-method folder
+
+# Split by files - creates filename.txt for each file
+make-folder-txt --split-method file
+
+# Split by size - creates part-1.txt, part-2.txt, etc.
+make-folder-txt --split-method size --split-size 5MB
+
+# Combine with other options
+make-folder-txt --split-method size --split-size 2MB --ignore-folder node_modules
+```
+
+**Output Files:**
+- **Folder method**: `projectname-foldername.txt`
+- **File method**: `projectname-filename.txt`  
+- **Size method**: `projectname-part-1.txt`, `projectname-part-2.txt`, etc.
+
+**Note**: Splitting is not compatible with `--copy` flag.
+
+Ignore specific folders/files by name:
+
+```bash
+make-folder-txt --ignore-folder examples extensions docs
+make-folder-txt -ifo examples extensions docs  # shorthand
+make-folder-txt --ignore-folder examples extensions "docs and explaination"
+make-folder-txt --ignore-folder examples extensions docs --ignore-file LICENSE
+make-folder-txt --ignore-file .env .env.local secrets.txt
+make-folder-txt -ifi .env .env.local secrets.txt  # shorthand
+```
+
+Use a `.txtignore` file (works like `.gitignore`):
+
+```bash
+# Create a .txtignore file in your project root
+echo "node_modules/" > .txtignore
+echo "*.log" >> .txtignore
+echo ".env" >> .txtignore
+echo "coverage/" >> .txtignore
+
+# The tool will automatically read and respect .txtignore patterns
+make-folder-txt
+```
+
+The `.txtignore` file supports:
+- File and folder names (one per line)
+- Wildcard patterns (`*.log`, `temp-*`)
+- Comments (lines starting with `#`)
+- Folder patterns with trailing slash (`docs/`)
+
+Include only specific folders/files by name (everything else is ignored):
+
+```bash
+make-folder-txt --only-folder src docs
+make-folder-txt -ofo src docs  # shorthand
+make-folder-txt --only-file package.json README.md
+make-folder-txt -ofi package.json README.md  # shorthand
+make-folder-txt --only-folder src --only-file package.json
+```
+
+---
+
+## 🎯 Real World Examples
+
+**Sharing with an AI tool (ChatGPT, Claude, etc.):**
+
+```bash
+cd "C:\Web Development\my-app\backend"
+make-folder-txt
+# → backend.txt created, ready to paste into any AI chat
+```
+
+**On macOS / Linux:**
+
+```bash
+cd /home/user/projects/my-app
+make-folder-txt
+# → my-app.txt created
+```
+
+---
+
+## 📄 Output Format
+
+The generated `.txt` file is structured in two clear sections:
+
+```
+================================================================================
+START OF FOLDER: my-project
+================================================================================
+
+================================================================================
+PROJECT STRUCTURE
+================================================================================
+Root: C:\Web Development\my-project
+
+my-project/
+├── src/
+│   ├── controllers/
+│   │   └── userController.js
+│   ├── models/
+│   │   └── User.js
+│   └── index.js
+├── node_modules/  [skipped]
+├── package.json
+└── README.md
+
+Total files: 5
+
+================================================================================
+FILE CONTENTS
+================================================================================
+
+--------------------------------------------------------------------------------
+FILE: /src/index.js
+--------------------------------------------------------------------------------
+const express = require('express');
+...
+
+--------------------------------------------------------------------------------
+FILE: /package.json
+--------------------------------------------------------------------------------
+{
+  "name": "my-project",
+  ...
+}
+
+================================================================================
+END OF FOLDER: my-project
+================================================================================
+```
+
+---
+
+## 🚫 What Gets Skipped
+
+The tool is smart about what it ignores so your output stays clean and readable.
+
+| Category        | Details                                                        |
+| --------------- | -------------------------------------------------------------- |
+| 📁 Folders      | `node_modules`, `.git`, `.next`, `dist`, `build`, `.cache`     |
+| 🖼️ Binary files | Images (`.png`, `.jpg`, `.gif`...), fonts, videos, executables |
+| 📦 Archives     | `.zip`, `.tar`, `.gz`, `.rar`, `.7z`                           |
+| 🔤 Font files   | `.woff`, `.woff2`, `.ttf`, `.eot`, `.otf`                      |
+| 📋 Lock files   | `package-lock.json`, `yarn.lock`                               |
+| 📏 Large files  | Any file over **500 KB**                                       |
+| 🗑️ System files | `.DS_Store`, `Thumbs.db`, `desktop.ini`                        |
+| 📄 Output file  | The generated `foldername.txt` file (to avoid infinite loops)   |
+| 📝 .txtignore   | Any files/folders specified in `.txtignore` file               |
+
+Binary and skipped files are noted in the output as `[binary / skipped]` so you always know what was omitted.
+
+---
+
+## 🛠️ Requirements
+
+- **Node.js** v14.0.0 or higher
+- No other dependencies
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+
+1. Fork the repository
+2. Create your feature branch: `git checkout -b feature/my-feature`
+3. Commit your changes: `git commit -m 'Add my feature'`
+4. Push to the branch: `git push origin feature/my-feature`
+5. Open a Pull Request
+
+---
+
+## 👤 Author
+
+**Muhammad Saad Amin**
+
+---
+
+## 📝 License
+
+This project is licensed under the **MIT License** — feel free to use it in personal and commercial projects.
+
+---
+
+<div align="center">
+
+If this tool saved you time, consider giving it a ⭐ on npm!
+
+</div>
+
+
+================================================================================
+END OF FOLDER: make-folder-txt
+================================================================================