Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
XCFolder is a command-line tool in Swift that exists to convert old Xcode’s virtual groups into physical directories on your disk. In doing so, users preserve the structure reflected in Xcode’s project navigator.
Xcode, in its early days, had the feature to organize files into groups. Unfortunately, these organizational placeholders don’t correspond to real filesystem folders. Over time, this evolved into a significant issue where messy repository structures and merge conflicts.
Thanks to XCFolder, developers can modernize iOS and macOS codebases and minimize merge-conflict overhead.
Key Features
- Smart Group Conversion
- Perfect Synchronization
- Automated Organization
- Flexible Configuration
- Space-Friendly Paths
Pros & Cons
| Pros | Cons |
| Intelligently transforms Xcode virtual groups into physical directories while preserving project structure. | Limited Visibility in Xcode UI. |
| Maintains 1:1 mapping between Xcode project navigator and filesystem directories. | Manual Integration & Maintenance Overhead. |
| Prepares your project structure for modern build systems like Tuist and XcodeGen. | |
| Handles project names and paths containing spaces correctly. |
Pricing & Plans
Since XCFolder is an open-source tool licensed under the MIT license, it’s available free of charge. You can support the developer via “Buy Me a Coffee,” but it’s purely voluntary.
Conclusion
By using XCFolder, bridge the gap between Xcode’s virtual group system and the physical structure on disk.
Whether it’s a group project or a solo venture, the tool provides a modern, configuration-driven solution that works great with Tuist or XcodeGen.
Forget about the mess. Instead, focus on bringing structure to your project with XCFolder.