Project Structure Creator

A Node.js CLI tool that generates project directory and file structures from a pasted tree schema. Quickly scaffold new projects or extend existing ones without overwriting current files.

Versions

This repository contains the English versions of the tool:

Version	Directory	Description
V3_EN	releases/v3_en	Full version — two modes (overwrite + append layer), welcome screen
V4_EN	releases/v4_en	Simplified version — single mode (overwrite)

Polish versions (V1_PL, V2_PL) are available in a separate repository: StrukturaProjektu.

Quick Start

cd releases/v3_en
node app.js

Workflow (V3)

1. Select a mode (1 — overwrite or 2 — add layer).
2. Enter the path to the parent directory.
3. Enter the project folder name.
4. Paste a tab-indented tree structure.
5. Type END to execute.

Example Structure

newsletter-app/
	public/
		index.html
		script.js
	subscribers.json
	server.js
	package.json

Repository Structure

ProjectStructure/
├── .gitignore
├── LICENSE
├── README.md
├── CHANGELOG.md
├── docs/
│   ├── RELEASES.md
│   ├── VERSION_MAP.md
│   └── AUDIT_REPORT.md
└── releases/
    ├── v3_en/
    │   ├── app.js
    │   ├── package.json
    │   └── README.md
    └── v4_en/
        ├── app.js
        ├── package.json
        └── README.md

Requirements

• Node.js (v14 or later)
• No external dependencies — uses only built-in Node.js modules

Version Comparison

Aspect	V3_EN	V4_EN
Operation modes	Two (overwrite + append layer)	Single (overwrite)
Welcome screen	Yes	None
Existing file handling	Mode-dependent (overwrite or skip)	Always overwrites
Console icons	Full emoji set	Minimal (only ✅ and ❌)
Functions	createStructureOverwrite, createStructureAppend	createStructure

Notes

• The structure is based on tab characters (\t) for nesting depth.
• Names containing a dot (.) are recognized as files; all others as directories.

License

MIT © 2025 Dariusz Justynski