make-folder-txt 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+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.

package/README.md

@@ -0,0 +1,89 @@
+# make-folder-txt
+
+Generate a single `.txt` file containing the **full folder structure** and **contents of every file** in your project — perfect for sharing codebases with AI tools or teammates.
+
+Automatically ignores `node_modules`, `.git`, `dist`, `build`, and binary files.
+
+---
+
+## Installation
+
+```bash
+npm install -g make-folder-txt
+```
+
+---
+
+## Usage
+
+```bash
+make-folder-txt <folder-path> [output-file.txt]
+```
+
+### Examples
+
+```bash
+# Basic — output saved as <folder-name>.txt in current directory
+make-folder-txt "C:\Web Development\my-project"
+
+# Custom output file name
+make-folder-txt "C:\Web Development\my-project" my-output.txt
+
+# On Mac/Linux
+make-folder-txt /home/user/my-project
+```
+
+---
+
+## Output Format
+
+```
+================================================================================
+START OF FOLDER: my-project
+================================================================================
+
+================================================================================
+PROJECT STRUCTURE
+================================================================================
+Root: C:\Web Development\my-project
+
+my-project/
+├── src/
+│   ├── index.js
+│   └── utils.js
+├── node_modules/  [skipped]
+├── package.json
+└── README.md
+
+Total files: 4
+
+================================================================================
+FILE CONTENTS
+================================================================================
+
+--------------------------------------------------------------------------------
+FILE: /src/index.js
+--------------------------------------------------------------------------------
+... file content here ...
+
+================================================================================
+END OF FOLDER: my-project
+================================================================================
+```
+
+---
+
+## What Gets Skipped
+
+| Type | Details |
+|------|---------|
+| Folders | `node_modules`, `.git`, `.next`, `dist`, `build`, `.cache` |
+| Binary files | Images, fonts, zips, executables, media |
+| Large files | Any file over 500 KB |
+| System files | `.DS_Store`, `Thumbs.db`, `desktop.ini` |
+
+---
+
+## License
+
+MIT

package/make-folder-txt.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+
+// ── config ────────────────────────────────────────────────────────────────────
+const IGNORE_DIRS = new Set(["node_modules", ".git", ".next", "dist", "build", ".cache"]);
+const IGNORE_FILES = new Set([".DS_Store", "Thumbs.db", "desktop.ini"]);
+
+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 collectFiles(dir, rootDir, indent = "", lines = [], filePaths = []) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return { lines, filePaths };
+  }
+
+  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 (IGNORE_DIRS.has(entry.name)) {
+        lines.push(`${indent}${connector}${entry.name}/  [skipped]`);
+        return;
+      }
+      lines.push(`${indent}${connector}${entry.name}/`);
+      collectFiles(path.join(dir, entry.name), rootDir, childIndent, lines, filePaths);
+    } else {
+      if (IGNORE_FILES.has(entry.name)) 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 };
+}
+
+function readContent(absPath) {
+  const ext = path.extname(absPath).toLowerCase();
+  if (BINARY_EXTS.has(ext)) return "[binary / skipped]";
+  try {
+    const stat = fs.statSync(absPath);
+    if (stat.size > 500 * 1024) {
+      return `[file too large: ${(stat.size / 1024).toFixed(1)} KB – skipped]`;
+    }
+    return fs.readFileSync(absPath, "utf8");
+  } catch (err) {
+    return `[could not read file: ${err.message}]`;
+  }
+}
+
+// ── main ──────────────────────────────────────────────────────────────────────
+
+const folderPath = process.cwd();
+
+const rootName = path.basename(folderPath);
+
+const outputFile = process.argv[3]
+  ? path.resolve(process.argv[3])
+  : path.join(process.cwd(), `${rootName}.txt`);
+
+console.log(`\n📂  Scanning: ${folderPath}`);
+
+const { lines: treeLines, filePaths } = collectFiles(folderPath, folderPath);
+
+// ── build output ──────────────────────────────────────────────────────────────
+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));
+});
+
+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}\n`);

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "make-folder-txt",
+  "version": "1.0.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": "AnnonymousThinker",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  }
+}