make-folder-txt 1.2.0 → 1.3.0

package/README.md

@@ -59,6 +59,25 @@ make-folder-txt --ignore-folder examples extensions docs --ignore-file LICENSE
 make-folder-txt --ignore-file .env .env.local secrets.txt
 ```
 
+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
@@ -155,6 +174,7 @@ The tool is smart about what it ignores so your output stays clean and readable.
 | 📏 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.
 

package/bin/make-folder-txt.js

@@ -19,6 +19,24 @@ const BINARY_EXTS = new Set([
 
 // ── 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 collectFiles(
   dir,
   rootDir,
@@ -35,6 +53,7 @@ function collectFiles(
     inSelectedFolder = false,
     hasOnlyFilters = false,
     rootName = "",
+    txtIgnore = new Set(),
   } = options;
 
   let entries;
@@ -62,6 +81,14 @@ function collectFiles(
         return;
       }
 
+      // Check against .txtignore patterns
+      if (txtIgnore.has(entry.name) || txtIgnore.has(`${entry.name}/`)) {
+        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 = [];
@@ -80,6 +107,7 @@ function collectFiles(
           inSelectedFolder: childInSelectedFolder,
           hasOnlyFilters,
           rootName,
+          txtIgnore,
         },
       );
 
@@ -94,6 +122,9 @@ function collectFiles(
     } else {
       if (ignoreFiles.has(entry.name)) return;
 
+      // Check against .txtignore patterns
+      if (txtIgnore.has(entry.name)) return;
+
       // Ignore .txt files that match the folder name (e.g., foldername.txt)
       if (entry.name.endsWith('.txt') && entry.name === `${rootName}.txt`) return;
 
@@ -255,6 +286,9 @@ for (let i = 0; i < args.length; i += 1) {
 const folderPath = process.cwd();
 const rootName = path.basename(folderPath);
 
+// Read .txtignore file if it exists
+const txtIgnore = readTxtIgnore(folderPath);
+
 const outputFile = outputArg
   ? path.resolve(outputArg)
   : path.join(process.cwd(), `${rootName}.txt`);
@@ -269,7 +303,7 @@ const { lines: treeLines, filePaths } = collectFiles(
   ignoreFiles,
   onlyFolders,
   onlyFiles,
-  { hasOnlyFilters, rootName },
+  { hasOnlyFilters, rootName, txtIgnore },
 );
 
 // ── build output ──────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "make-folder-txt",
-  "version": "1.2.0",
+  "version": "1.3.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": {