Swap Main Component - Local or Remote - Keep instances

About this plugin

Ever tried to swap a component, only to watch all your carefully crafted text overrides, states, and properties disappear? Or maybe you're migrating a design system and need to replace hundreds of instances across multiple pages safely?Swap Main Component takes the anxiety out of swapping. It analyzes your source and replacement components before you make a change, ensuring that your overrides are preserved and letting you know exactly what to expect.✨ Why use this plugin?Override Preservation: Keeps your text, color, and property overrides intact when moving from an old component to a new one.Pre-flight Checks: Don't guess if a swap will break your design. The plugin runs an instant compatibility check and warns you if properties differ or if values will be reset.Bulk Swapping Made Easy: Easily apply swaps to just your current selection, everything on the current page, or across your entire Figma file in one click.Intuitive Drag & Drop: A clean, visual interface lets you simply drag and drop the current instance and its new replacement component to set up the swap.Variant Aware: It understands component sets. You can easily map instances of one variant to another while keeping the underlying structure aligned.🚀 How to use itSelect the instance (or instances) you want to replace in your Figma canvas.Open the plugin. You'll see your selection listed.Drag and drop one of the selected instances into the "Current" slot.Find the new component you want to use (from your assets panel or canvas) and drag an instance of it into the "New" slot.Review the analysis: The plugin will instantly tell you if they are compatible. Look out for the orange warning badge if some properties don't match perfectly.Choose your scope: Decide if you want to swap just the selected items, all matching instances on the Page, or across the entire File.Click "Swap"!💡 Perfect for:Design System migrations (moving from v1 to v2 components).Cleaning up detached or messy local components.Replacing placeholder assets with finalized components globally.Stop doing manual swaps. Let Swap Main Component do the heavy lifting safely.