📂 Folder Structure Navigator v1.0.0
A VS Code extension to generate, explore, and export customizable folder structures — with advanced filtering, multiple formats, AI-powered insights, and performance optimization.
🚀 Key Features
Feature |
Description |
Multiple Output Formats |
Export structures as Tree View, JSON, Markdown, or XML. |
Advanced Filtering |
Exclude folders, filter by extensions, ignore glob patterns, and respect .gitignore . |
AI-Powered Analysis |
Detects project type, finds structural issues, and provides recommendations. |
Directory Comparison |
Side-by-side comparison of two different directories. |
Batch Processing |
Generate reports for multiple directories at once. |
Template System |
Save/load configuration presets for reuse. |
Performance Optimized |
Uses caching for faster repeated operations. |
Detailed Metadata |
Optionally include size, permissions, and modified dates. |
Interactive Wizard |
Step-by-step guide to configure generation without editing settings. |
📦 Installation
- Open Visual Studio Code.
- Go to Extensions (
Ctrl+Shift+X
).
- Search for "Folder Structure Navigator v2.0".
- Click Install.
Or via CLI:
code --install-extension samarthasmg14.folder-structure-navigator
🎯 Quick Start
- Right-click on any folder in the VS Code Explorer.
- Select Generate Folder Structure.
- View the structure in a new file (auto-saved).
👉 For more control, choose Generate Interactive Structure and follow the prompts.
🛠️ Commands
Command |
ID |
Shortcut |
Generate Folder Structure |
generateStructure |
Ctrl+Alt+S |
Generate Interactive Structure |
generateInteractiveStructure |
Ctrl+Alt+Shift+S |
Compare Directories |
compareDirectories |
– |
Export Structure |
exportStructure |
– |
Manage Templates |
manageTemplates |
– |
Show Performance Report |
showPerformanceReport |
– |
Generate with Analysis |
generateWithAnalysis |
– |
Batch Process Directories |
batchProcess |
– |
⚙️ Configuration
Add custom settings in settings.json
:
Setting |
Description |
Default |
includeHiddenFiles |
Include hidden files (. prefix). |
false |
extensionFilter |
Limit by extensions (["js","ts"] ). |
null |
excludeFolders |
Folders to skip. |
["node_modules",".git"] |
excludePatterns |
Glob patterns to skip (e.g., *.log ). |
["*.log","*.tmp"] |
maxDepth |
Max folder depth (0 = unlimited). |
10 |
respectGitignore |
Respect .gitignore rules. |
true |
includeSize |
Show file/folder sizes. |
false |
includePermissions |
Show file permissions. |
false |
includeModifiedDate |
Show last modified date. |
false |
sortBy |
Sort by name , size , modified , or type . |
"name" |
outputFormat |
Default format (tree , json , markdown , xml ). |
"tree" |
useProgressIndicator |
Show progress during generation. |
true |
enableCaching |
Enable caching for speed. |
true |
iconStyle |
Icon style: emoji , unicode , ascii , none . |
"emoji" |
customIcons |
Map extensions to icons. |
{} |
compressLargeDirs |
Collapse large directories. |
true |
compressionThreshold |
Collapse if > N items. |
50 |
autoSave |
Auto-save generated structures. |
true |
autoOpen |
Auto-open after creation. |
true |
Tree View (default)
📁 my-project
├── 📄 README.md (2.1 KB)
├── 📁 src
│ ├── 📄 index.js (3.2 KB)
│ └── 📁 components
│ └── 📄 Header.jsx (1.8 KB)
JSON
{
"metadata": {
"generatedAt": "2025-08-16T15:37:12.000Z",
"generationTime": "150ms",
"itemsProcessed": 25
},
"structure": {
"name": "my-project",
"type": "directory",
"children": [...]
}
}
Markdown
# 📁 my-project
**Generated:** 2025-08-16T15:37:12.000Z
**Generation Time:** 150ms
## Directory Structure
...
🔧 Advanced Usage
Templates
- Save Template:
Manage Templates
→ Save Current Config
- Load Template:
Manage Templates
→ Load Template
- Stored in
.vscode/folder-navigator-templates.json
.
AI-Powered Analysis
Run Generate with Analysis → produces a report with:
- Detected project type (e.g., React, Node.js, Python).
- Health checks (deep nesting, missing LICENSE, etc).
- Best practice recommendations.
- Detected frameworks/tools.
🐛 Troubleshooting
- Slow on big projects? Exclude heavy folders (
node_modules
) and lower maxDepth
.
- Report bugs/requests → GitHub Issues.
🤝 Contributing
Contributions welcome! Fork → improve → PR.
📄 License
MIT License — see LICENSE.