ResourcesAutoSyncer

ResourcesAutoSyncer is a highly flexible VS Code extension that automatically synchronizes files and directories between specified folder pairs within your workspace.

Instead of relying on manual commands, synchronization rules are defined declaratively in a configuration file, allowing you to track multiple sources and destinations simultaneously, and commit your sync rules to version control.

Features

• Multi-Folder Syncing: Map as many source and destination folder pairs as you need.
• Auto-Sync on Save: Modified files are automatically copied to their mapped destination.
• Create & Delete Sync: New files/directories are copied, and deleted files/directories are removed from the destination automatically.
• Rename Sync: Renames are cleanly mirrored in the destination folder.
• Hot-Reloading: Edits to your configuration file are applied instantly without reloading the editor.
• Non-Blocking Performance: Built on modern Node.js asynchronous APIs to keep your VS Code instance fast.
• Manual Sync All: Run a single command to completely synchronize all mapped folders at once, perfect for initial workspace setup.

Usage & Configuration

1. Install the extension.
2. Create a .vscode folder in the root of your project (if it doesn't already exist).
3. Inside the .vscode folder, create a file named .sync-config.json.
4. Define your folder mappings using absolute paths.

Manual Synchronization

If you are opening the workspace for the first time or need to forcefully synchronize all files, you can use the command palette:

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on Mac).
2. Run the command ResourcesAutoSyncer: Sync All.

The extension activates automatically when you open a workspace and will immediately begin watching your configured folders.

Example .sync-config.json

{
    "mappings": [
        {
            "source": "C:\\Users\\username\\Desktop\\source_folder",
            "destination": "C:\\Users\\username\\destination_folder"
        },
        {
            "source": "/Users/username/Projects/my-app/src",
            "destination": "/Users/username/dist"
        }
    ]
}