Folder Mapper is a tool to generate snapshots of a folder structure. It's the perfect tool for providing AI agents with a project overview or sharing your project's architecture with team members.
Features
📊 Text-Based Mapping: Generate a comprehensive text-based map of your folder structure.
🔍 Depth Control: Customize the mapping depth to focus on specific levels of your project.
🚫 Smart Exclusions: Utilize ignore files (.gitignore, .vscignore, .foldermapperignore) to exclude specific files or directories from mapping.
🖥️ User-Friendly Interface: Navigate and operate the extension effortlessly through a sleek sidebar interface.
⏳ Real-Time Progress: Track the mapping process with a visual progress bar for instant feedback.
📂 Flexible Output: Choose your preferred location to save the generated folder structure map.
🎨 Theme-Aware Design: Experience a seamless look with UI that automatically adapts to your VS Code theme.
⚡ Efficient Performance: Quickly generate maps even for large and complex project structures.
How to Use
Open the Folder Mapper sidebar in VS Code.
Click "Select Folder to Map" to choose the folder you want to map.
(Optional) Click "Select Output Folder" to choose where to save the map file.
Set the "Depth Limit" if you want to restrict the mapping depth (0 for unlimited).
(Optional) Select an ignore file from the dropdown menu to exclude specific files or directories.
Click "Start Mapping" to generate the folder structure map.
Folder Mapper in action:
Requirements
This extension requires Visual Studio Code version 1.93.0 or higher.
Extension Settings
Folder Mapper works out of the box with no additional configuration required!
Known Issues
There are no known issues at this time. If you encounter any problems, please report them on our GitHub issues page.
What's New in 1.2.31
Ignore feature: Users can now select and use ignore files (like .gitignore) to exclude specific files or directories from mapping.
Dropdown menu in the UI for selecting ignore files.
Resolved an issue where the ignore file feature was not working due to the wrong configuration of the .vscodeignore file.